Queue a post: at a time, in the next free queue slot, or now.

post/api/posts

Request

  • Base URL: https://shapelessai.com
  • URL: https://shapelessai.com/api/posts
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://shapelessai.com/api/auth/mcp/authorize, token URL https://shapelessai.com/api/auth/mcp/token, scopes: publish)

Request body

connectionIdstring required

The target account (GET /api/connections).

postTextstring required
mediaKeysstring[]

Keys from an upload route; the account's own media only.

documentTitlestring

Required on YouTube (the video title).

scheduledAtstring date-time

When it goes out. Omitted or past = publish now.

queuetrue

Instead of scheduledAt: the next free slot of the account's queue.

settingsobject

Per-platform knobs; the schema is GET /api/platforms[].settingsSchema.

firstCommentstring

Posted as the post's own first reply the moment it is live. LinkedIn (1250), X (280), Bluesky (300).

Response

OK

idstring required
status'scheduled' | 'published' | 'failed' | 'handoff' required
scheduledAtstring date-time
publishedLocationstring nullable
errorstring nullable
handoffNotestring

Changes

No recorded changes to this operation across all 2 revisions of this API.