Skip to main content

Endpoint

Overview

Check the current status of a specific post. Use this endpoint to monitor whether a post has been successfully published or if there were any issues.

Post Status Values

  • scheduled - Post is scheduled to be published at a future time
  • pending - Post is currently being processed/published
  • complete - Post was successfully published to the platform
  • failed - Post failed to publish; see fail_category for why

Failure Categories

When status is failed, fail_category explains why:
  • device_error - The posting device was unavailable or did not respond
  • network_error - The connection dropped while posting
  • upload_interrupted - The upload started but could not be confirmed as finished
  • account_issue - The social account was not in a usable state
  • capacity_deferred - No posting capacity was available; the post will be retried
  • platform_change - The social app’s interface changed and the post could not complete
  • unconfirmed - Posting finished but publication could not be confirmed
  • unknown - The post failed for an unrecognized reason

Request Body

string
required
Post ID to check status for

Response

object
Status information for the post