Social checklist

Submit a Social checklist item's output for approval

Changed on

Hand one item's finished output to a person. A social_post becomes one post at needs_review in the Social review queue. A document, for an item whose person action is Approve, Request change or Deny, becomes one pending approval card; when a person asked for a change on the item's last card, it is the redo. 409 card_waiting while a card waits for a person, 409 output_kind_not_accepted when the item does not take that output. Nothing is published, sent, approved or scheduled by this call: a person decides. Requires the social_checklist.submit scope.

post/social/checklist/items/{id}/submissions

Request

  • Base URL: https://www.sagaris.ai/api/v1
  • URL: https://www.sagaris.ai/api/v1/social/checklist/items/{id}/submissions
  • Auth: HTTP bearer

Path parameters

idstring required

A Social checklist item id from the catalog, such as OT-02 (one-time) or ON-46 (ongoing).

Headers

Idempotency-Keystring

Opaque client-supplied key. A retry with the same key replays the original response instead of writing again.

Request body

output_kind'social_post' | 'document' required

social_post goes to the Social review queue; document becomes an approval card.

platform'linkedin' | 'x' | 'instagram' | 'facebook' | 'tiktok' | 'blog' | 'youtube' | 'youtube_shorts' | 'pinterest' | 'threads'

social_post only: the channel the post is written for.

titlestring

Required for a document (at most 200 characters, the card's title); optional for a social_post.

bodystring required

The finished work a person reviews. A social_post body is at most 20000 characters; a document's summary and body together fit an approval card, at most 4000.

scheduled_forstring date-time

social_post only: a suggested publish time in the future. The reviewer sets the real one.

summarystring

document only: one or two lines shown above the body on the approval card.

Response

The draft post or approval card, waiting for a person.

errorunknown required

Changes