Posteady
Posteady Docs
User guideDeveloper guidesAPI referenceMCP
API referencePublish jobs

Get publishing status

Check whether an accepted media job has been published, failed, or is still in progress.

GET
/api/v1/publish-jobs/{id}
curl -X GET "https://example.com/api/v1/publish-jobs/44444444-4444-4444-8444-444444444444"

{  "jobId": "44444444-4444-4444-8444-444444444444",  "scheduledPostId": "55555555-5555-4555-8555-555555555555",  "platform": "instagram",  "accountId": "11111111-1111-4111-8111-111111111111",  "username": "your_brand",  "status": "queued",  "postId": null,  "permalink": null,  "scheduledAt": null}

Return the status of a TikTok video, Instagram media, YouTube video, or Facebook Page 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.

AuthorizationBearer <token>

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json