Skip to navigation

Social · Drafts · Update a draft social media post

View as Markdown

Update the content, schedule, or media of a draft post. Only provided fields are changed.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
draft_idstringRequired
ID of the draft to update
messagestringOptional
New draft message content
datestringOptional

New scheduled date (e.g. 2026-04-15)

timestringOptional

New scheduled time (e.g. 14:30)

timezonestringOptional

Timezone for the scheduled date/time (e.g. Europe/Warsaw)

medialist of strings or objectsOptional

Updated media for the draft. Each entry is a Simplified asset UUID, a fully qualified URL, or a { url, thumbUrl } object — see MediaItem and CreatePostRequest.media for resolution rules.

tagslist of integersOptional

Replace the draft's tag (label) IDs with this list. Use listSocialMediaTags to fetch existing IDs and createSocialMediaTag to add new ones.

Response

Draft updated successfully