Posteady
Posteady Docs
APIMedia

List workspace media

List supported active media visible in the API key's workspace library. mediaType defaults to VIDEO for backward compatibility; pass IMAGE for JPEG. Use mediaId in a supported publishing or scheduling request. Unconfirmed uploads are excluded. The account and media must belong to the same workspace.

GET
/api/v1/media

Authorization

apiKey
AuthorizationBearer <token>

In: header

Query Parameters

mediaType?string
Default"VIDEO"

Value in

  • "IMAGE"
  • "VIDEO"
limit?integer
Range1 <= value <= 100
Default20
offset?integer
Range0 <= value <= 10000
Default0

Response Body

application/json

curl -X GET "https://example.com/api/v1/media"
{  "media": [    {      "mediaId": "5a8ffac5-2288-485d-b463-90c3cd9941ad",      "fileName": "string",      "mediaType": "IMAGE",      "mimeType": "string",      "fileSize": 0,      "url": "http://example.com",      "duration": 0,      "width": 0,      "height": 0,      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "total": 0,  "hasMore": true}

Create a media upload POST

Reserve a media ID and get a presigned private staging upload URL. VIDEO accepts MP4 or QuickTime up to 2 GiB; IMAGE accepts JPEG up to 8 MiB. Omitted mediaType defaults to VIDEO. PUT the file bytes directly to uploadUrl within 300 seconds using every returned requiredHeaders value, then call POST /api/v1/media/uploads/confirm with fileKey. This request does not upload the file and its reserved mediaId is not ready for publishing yet. Confirm within 24 hours of creating the upload. The reserved file size counts toward the organization's media storage quota; expired unconfirmed uploads are cleaned up. Workspace selection comes from the API key.

Repost an existing post POST

Repost (reshare) an existing post to the connected account's own feed. X = retweet, Threads = repost, LinkedIn = repost. One account reposts one post. The target account must have capabilities.repostPosts=true. TikTok, Instagram, and YouTube are not supported.