Posteady
Posteady Docs
APIPublish jobs

Get media publishing status

Return the status of a TikTok video, Instagram media, or YouTube video job in the API key's workspace. Use jobId from a publishing or scheduling result. Account and workspace access are checked on every request. Wait for published before treating the media as published. If status is unknown, the submission outcome is uncertain and Posteady will not automatically submit it again; check the platform before deciding whether to create a new request.

GET
/api/v1/publish-jobs/{id}

Authorization

apiKey
AuthorizationBearer <token>

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v1/publish-jobs/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "jobId": "9d222c6d-893e-4e79-8201-3c9ca16a0f39",  "scheduledPostId": "4fcfdd01-4452-4c3b-884b-76337b06ee87",  "platform": "tiktok",  "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",  "username": "string",  "status": "queued",  "postId": "string",  "permalink": "string",  "scheduledAt": "2019-08-24T14:15:22Z",  "error": {    "code": "string",    "message": "string"  }}

Publish post(s) immediately POST

Publish text to Threads, X, or LinkedIn, enqueue one public TikTok video, enqueue an Instagram FEED, REELS, or STORIES media post, or enqueue one YouTube video. TikTok, Instagram, and YouTube media requests require confirmed media IDs and a UUID requestId. An accepted media job returns HTTP 202 and results[0].jobId; success means accepted, not published. Check GET /api/v1/publish-jobs/{id} for its outcome. Retrying the same unchanged requestId returns its existing job.

Confirm a media upload POST

Confirm media after uploading it to the issued URL. Posteady checks the stored file's size, content type, signature, and object version against the upload reservation before promoting it from private staging. fileKey must belong to a reservation in the API key's workspace and be confirmed within 24 hours. Posteady measures duration, width, and height for supported MP4/QuickTime files; include the client-observed values when available. Instagram publishing rejects video records without all three values. Confirmation uses the existing storage reservation and does not count the file size twice. A confirmed upload does not publish it.