latestOpenAPI 3.1.02026-08-13511119.5 KB

e91a4f756dfe

Posts

Update a post

Updates a post. Published posts are immutable and will return 400. The media field: Up to 20 public image or video URLs, each max 100MB. Files are downloaded server-side from the provided URLs. Pass an empty array to clear media. Stories support a single, non-GIF media item; submitting multiple media URLs or a GIF for a story returns 400. Set archived to true to archive a post or false to restore it; archiving removes any active schedule. Use videoThumbnail to set a custom video thumbnail (cover) from an image URL or from a video frame offset; the post must have a fully transcoded video (the first video is used for mixed media). Set notify to false to suppress notifications (email/in-app push, Zapier) for the edit activities created by this update; internal activity feed entries are always recorded. notify modifies nothing by itself, so it does not count towards the at-least-one-field requirement. It is not an approval request — use POST /posts/{id}/request-approval to notify approvers.

patch/posts/{id}

Path parameters

idstring required

Request body

textstring
scheduledAtstring date-time nullable
labelsstring[]
mediastring[]

Up to 20 public image or video URLs, each max 100MB. Files are downloaded server-side from the provided URLs.

teamOnlyboolean
approvedboolean
approvedBystring
linkedinPdfTitlestring

LinkedIn PDF carousel title (linkedinData.pdfTitle). When set on a LinkedIn post with multiple images, also enables publishing as a PDF document carousel (linkedinData.publishCarouselAsPdf). Pass an empty string on PATCH to disable PDF mode and clear the title.

linkedinVideoTitlestring
publishAtScheduledDateboolean
archivedboolean
campaignIdstring nullable
notifyboolean

When false, the edit activities created by this update do not trigger notifications (email/in-app push, Zapier). Modifies nothing by itself, so at least one other field must be provided.

Response

Updated post detail