Posts

Update a post

Update an existing draft or scheduled post by its ID. title sets the post-level title; on Facebook it's an alias for platformConfiguration.title (the video title), and either one updates both. Send null or an empty string to clear it. status may be DRAFT, SCHEDULED (requires a future scheduledAt, either in this request or already on the post), or PROCESSING (publish now). COMPLETED and FAILED are set only by the publisher. A new scheduledAt must not be in the past, whatever the status (422). media replaces the post's media and accepts the same items as create — a stored or public URL ({ url }) or a media library id ({ id }), so the media array from GET /v0/posts/{id} can be sent back as-is. parts (X and Mastodon only) replaces the post's thread with the same items create accepts — part media may also be a library { id }, so the parts array from GET /v0/posts/{id} round-trips — and an empty array removes the thread. On X, parts[0] is the opening tweet: sending parts without caption sets the caption to parts[0], and changing caption or media without parts updates parts[0] when it matched the old value. Posts that are already publishing, published, or failed can't be edited (409).

put/v0/posts/{id}

Request

  • Base URL: https://api.schedulin.app
  • URL: https://api.schedulin.app/v0/posts/{id}
  • Auth: one of:
    • API key in header x-api-key
    • OAuth 2 (authorization code, authorization URL https://api.schedulin.app/oauth/authorize, token URL https://api.schedulin.app/oauth/token, scopes: posts:write)

Path parameters

idstring required

Request body

captionstring
titlestring nullable
scheduledAtstring date-time nullable
platformConfigurationobject
status'DRAFT' | 'SCHEDULED' | 'PROCESSING'
tagIdsstring[]

Response

OK

idstring required
externalIdstring nullable required
captionstring required
status'SCHEDULED' | 'PROCESSING' | 'COMPLETED' | 'DRAFT' | 'FAILED' | 'DELETED' required
approvalStatus'DRAFT' | 'PENDING_APPROVAL' | 'APPROVED' | 'REJECTED' required
approvalRequestedAtstring date-time nullable required
approvalRequestedBystring nullable required
approvedAtstring date-time nullable required
approvedBystring nullable required
rejectionReasonstring nullable required
scheduledAtstring date-time nullable required
platformConfigurationobject nullable required
socialAccountIdstring required
urlstring nullable required
titlestring nullable required
postedAtstring date-time nullable required
errorMessagestring nullable required
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.