Your tools. One draft workflow.

Create a workspace, open API keys, and generate a key with only the permissions your agent needs.

POST /api/v1/workspaces/{workspaceId}/drafts
Authorization: Bearer YOUR_WORKSPACE_KEY
Content-Type: application/json
Idempotency-Key: my-first-draft

{
  "title": "A fresh perspective",
  "body": "Something worth sharing starts here.",
  "platform": "linkedin"
}

Draft endpoints

• GET /api/v1/workspaces — list accessible workspaces
• GET /api/v1/workspaces/:id/drafts — paginated list
• POST /api/v1/workspaces/:id/drafts — create a draft
• GET /api/v1/workspaces/:id/drafts/:draftId — retrieve a draft
• PATCH /api/v1/workspaces/:id/drafts/:draftId — update with the current version
• DELETE /api/v1/workspaces/:id/drafts/:draftId — delete a draft

Safe to retry

Supply Idempotency-Key when creating a draft. Reusing it with different content returns 409. Updates require title, body, platform and version; stale versions also return 409.

Private media

POST a multipart file to /api/v1/workspaces/:id/media. Attach the returned mediaId using POST /api/v1/workspaces/:id/drafts/:draftId/media. Reading the file requires authentication.

Limits

Lists default to 20 records, up to 100. Follow pagination.next_offset until it is null. Requests are limited to 120 per minute per account. Uploads accept PNG, JPEG, WebP and MP4 up to 25 MB. Keys expire after at most 365 days.

Publishing requires a signed-in user to preview and consent in the UI; API keys cannot publish. Draft creation never schedules or publishes a post.