Get Post Status

Check Post Status

Endpoint

Base URL: https://backend.blotato.com/v2

URL: /posts/:postSubmissionId

Method: GET

Rate Limit: 60 requests / minute

Description

Poll this endpoint to check the publishing status of a post. After submitting a post with Create Post, use the returned postSubmissionId to track its progress.

Request

Path Parameters

Field
Type
Required
Description

postSubmissionId

string

Yes

The post submission ID returned by the Create Post endpoint.

Responses

Success Response

Status Code: 200 OK

The response shape depends on the current status:

Published (terminal - success):

Failed (terminal - error):

In Progress (keep polling):

Response Keys

Field
Type
Description

postSubmissionId

string

The post submission ID.

status

string

One of: in-progress, published, failed.

publicUrl

string

The live URL of the published post. Present when status is published.

errorMessage

string

Description of the failure. Present when status is failed.

Polling Strategy

  1. Poll every 2 seconds after submitting a post.

  2. Continue while status is in-progress.

  3. Stop when status is published (success) or failed (error).

  4. Do not retry on failed -- most failures are permanent. Check errorMessage for details.

Failed posts are also visible at https://my.blotato.com/failedarrow-up-right.

Example

Last updated