Posts

/posts/{post_id}

Returns one post and its current status.

Publishing is asynchronous, so a post you created as immediate or scheduled will move through scheduled → publishing → published, or to failed. Poll this to learn the outcome; permalink appears once the provider returns one.

Requires the posts:read scope.

get/projects/{project_id}/posts/{post_id}

Request

  • Base URL: https://api.productbyte.com/v1
  • URL: https://api.productbyte.com/v1/projects/{project_id}/posts/{post_id}
  • Auth: HTTP bearer

Path parameters

project_idstring required

The project the post belongs to.

post_idstring required

The post to read.

Response

The post.

idstring required

Identifier for this post.

channel_idstring required

The channel it publishes to.

campaign_idstring

The campaign it belongs to. Absent when the post is unassigned — posts still need a home internally, but that grouping is bookkeeping and is never reported as a campaign.

status'draft' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'deleted' required

Where the post actually got to. Poll this to learn the outcome.

copystring required

The text published alongside the media.

scheduled_atstring date-time

When it publishes, if it is scheduled.

published_atstring date-time

When it published, once it has.

permalinkstring

Link to the published post, when the provider gives one.

updated_atstring date-time required

When the post last changed. Pass the newest one back as updated_since to poll for what changed.

Changes

No recorded changes to this operation across all 2 revisions of this API.