Posts

Update a post

Edit a draft, scheduled or failed post (409 not_editable otherwise). Send only what changes; tiktok merges field by field; other arrays and objects replace. scheduled_at set moves or schedules it (post.scheduled fires); scheduled_at null turns a scheduled post back into a draft. Requires the write scope.

patch/posts/{id}

Request

  • Base URL: https://sumgenius.ai/api/v1
  • URL: https://sumgenius.ai/api/v1/posts/{id}
  • Auth: one of:
    • API key in header X-SumGenius-Api-Key
    • HTTP bearer

Path parameters

idinteger required

Numeric id.

Request body

platform'instagram' | 'facebook' | 'both' | 'tiktok' | 'instagram_tiktok' | 'facebook_tiktok' | 'all'

A target set. both = Instagram + Facebook; all = all three.

post_type'feed_post' | 'carousel' | 'reels' | 'story'
captionstring
hashtagsstring[]

Without the #.

scheduled_atstring date-time nullable

ISO-8601. Null on PATCH turns a scheduled post back into a draft.

first_commentstring nullable

Posted under the post right after publish. Instagram and Facebook only.

collaboratorsstring[]

Instagram usernames to invite as collaborators. Instagram only.

cover_offset_msinteger nullable

Reels: which frame is the cover.

Response

OK

Changes

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