Skip to content

Overview - Posts APIs

Programmatic endpoints for scheduling, listing, flipping draft ↔ scheduled, and deleting posts using a workspace programmatic token.

2 min read

Connect your agent today

Draft from chat, review in your calendar, and publish only what you approve.

Start for $0

Endpoints

List Posts
Return calendar rows in an ISO date window, optionally filtered by channel UUID
Create Post
Create a draft or scheduled post group with one row per selected channel
Find Slot
Suggest the next free posting slot for the workspace (or one specific channel)
Flip post status
Flip draft ↔ scheduled for the group that a list row belongs to, without changing the stored publish time
Reschedule post
Move a post group to a new publish time; optionally re-queue or republish published rows
Get Post (row summary)
Resolve a list row UUID to its parent postGroup id
Delete Post
Delete a single post by row id (soft-deletes the whole post group it belongs to)
Missing Content
List provider-side candidate ids when the worker could not link a published row
Update Release ID
Manually link a post row to a provider-native id when worker auto-link failed
Update Review Todo
Set kanban review note and mark reviewed

Typical flow

  1. Pick channels — call GET /public/integrations to list connected channels, then collect the UUIDs you want to publish to.
  2. (Optional) Attach media — upload each asset via POST /public/upload and keep the returned id + path.
  3. Create — call POST /public/posts with the canonical body, any per-channel bodiesByIntegrationId and mediaByIntegrationId overrides, the shared media references, scheduledAt, and status (draft or scheduled). For agent/approval flows, set isAgent and optional note (kanban review checklist). The response includes the new postGroup UUID.
  4. Iterate — use the workspace composer or authenticated session APIs to change channels, copy, or media. Use PUT /public/posts/{postId}/reschedule with a row id to move publish time (action: update preserves state; schedule re-queues). Use PUT /public/posts/{postId}/status when you only need to flip draft ↔ scheduled at the same stored time.
  5. Remove — call DELETE /public/posts/{postId} with any row id from the group to soft-delete the whole group; already-published rows remain on the social provider.

Rate limits

Integrations APIs
Connect, list, delete, and inspect the channels referenced in `integrationIds`
Uploads APIs
Upload media that you pass back as `media[]` when creating a post group
Analytics APIs
Per-post analytics for the rows returned by List Posts
Public API
Authentication, base URL, payload wizard, and SDK quick start
Search documentation
Find a docs page
Discord Support