Post Scheduling

Drafts

A draft is a post group that is not on the calendar yet. Creating one, editing one, and reading one do not charge.

Create

content is the caption every target shares. type defaults to promotion. targets is the list of accounts. Each target needs accountId from Accounts. The response is 201 with the group, including its id.

POST/api/v1/scheduling/post-groupsschedule:write

content	Shared caption. Empty is allowed on a draft and refused at confirm.
type	promotion, knowledge_post, or comment_reply. Default promotion.
targets	Required to be useful. Each object needs accountId.
targets[].scheduledFor	ISO 8601 time for that account. Omit it to leave the time unset until confirm or a later edit.
targets[].content	Caption for that account only. Omit it to use the shared caption.
targets[].deliveryMode	manual (the default) when a person posts it and marks it done. api when we publish it to the network.
mediaUrls	Image or video URLs on the shared post. A target can set its own mediaUrls.
threadParts	Extra posts in a thread. A target can set its own.
firstComment	The first comment to place under the post, where the network allows it.

curl

curl -sS https://api.thealtermeai.com/api/v1/scheduling/post-groups \
  -H "Authorization: Bearer emk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "We just opened the May cohort.",
    "type": "promotion",
    "targets": [
      { "accountId": "ACCOUNT_ID", "scheduledFor": "2026-05-12T15:00:00.000Z" }
    ]
  }'

List and read

List returns this workspace’s groups, drafts and scheduled posts together. Read one group to see each target and any reason it is not ready to confirm.

GET/api/v1/scheduling/post-groupsschedule:read

GET/api/v1/scheduling/post-groups/{id}schedule:read

A group from another workspace is 404.

Update and cancel

PATCH changes the fields you send. Send targets to replace the account list. DELETE drops targets that have not published. A target that already went out stays on the network.

PATCH/api/v1/scheduling/post-groups/{id}schedule:write

DELETE/api/v1/scheduling/post-groups/{id}schedule:write