POpost-bridge
Posts

Update Post

Changed on

Update an existing post with the passed in data. If updating a 'scheduled' post make sure to always pass 'scheduled_at' otherwise the post will process immediately

patch/v1/posts/{id}

Request

  • Base URL
    https://api.post-bridge.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

idstring required

Post ID

Request body

captionstring

Caption text for the post

scheduled_atobject nullable

Scheduled date and time for the post, setting to null will post instantly

platform_configurationsobject nullable

Platform-specific configurations for the post

account_configurationsobject nullable

Account-specific configurations for the post

mediaobject nullable

Array of media IDs associated with the post

media_urlsstring[] nullable

Array of publicly accesible media URLs associated with the post, will be ignored if media is provided

social_accountsnumber[]

Array of social account IDs for posting

is_draftboolean nullable

If true will create the post but not process it until it is updated with a scheduled date or processed instantly

processing_enabledboolean nullable

If true will process video files to ensure they post, If false we will skip all video processing

Response

Post updated successfully.

idstring required

Unique identifier of the post

captionstring required

Caption text for the post

status'posted' | 'scheduled' | 'processing' | 'failed' required

Current status of the post: scheduled, processing, or posted

scheduled_atobject nullable required

Scheduled date and time for the post

platform_configurationsobject nullable required

Platform-specific configurations for the post

social_accountsnumber[] required

Array of social account IDs associated with the post

account_configurationsobject nullable required

Account-specific configurations for the post

mediaobject nullable required

Array of media URLs associated with the post

created_atstring required

Timestamp when the post was created

updated_atstring required

Timestamp when the post was last updated

is_draftboolean required

If true the post will not be processed until updated

warningsstring[]

Warnings about draft behavior — e.g. platforms that will publish immediately when the draft is sent

dashboard_urlstring required

Link to this post in the Post Bridge dashboard (view, edit, or see per-platform results). Give it to the user when they ask where the post is.

Changes