Developers

Drafts

An explicit draft-only creation endpoint. Behaviorally identical to POST /posts in v1, but future-proofed for when POST /posts learns to publish.

When to use this endpoint

Use POST /drafts in code that should always create a draft, even after we enable direct publishing on POST /posts. Common cases: AI agents proposing content for human approval, scheduled workflows that want a review step, third-party tools that don't want to be responsible for "ship to production social" semantics.

Create a draft

POST/api/v1/drafts

Same request body and field reference as POST /posts.

bash
curl -X POST https://postme.live/api/v1/drafts \
  -H "Authorization: Bearer pml_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Proposed copy for tomorrow",
    "channels": [{ "id": "5a1d…" }]
  }'

Response shape is identical to POST /posts: 202 Accepted with the new id, status: "draft", and a review_url.

Drafts — Public API