Examples

Preview API contract examples

These examples are safe documentation examples only. They use YOUR_API_KEY, workspace_id, approval_required: true and publish_mode: approval_queue. They do not contain real tokens.

curl: create draft and submit to approval queue

curl -X POST https://api.ai-social-poster.com/v1/drafts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "workspace_id",
    "source_text": "Launch update",
    "platforms": ["telegram", "instagram"],
    "approval_required": true,
    "publish_mode": "approval_queue"
  }'

Python: generate captions and precheck credits

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "workspace_id": "workspace_id",
    "draft_id": "draft_preview_id",
    "approval_required": True,
    "publish_mode": "approval_queue",
}
requests.post("https://api.ai-social-poster.com/v1/captions", json=payload, headers=headers)
requests.post("https://api.ai-social-poster.com/v1/usage/precheck", json=payload, headers=headers)

JavaScript: check publish job status

await fetch("https://api.ai-social-poster.com/v1/publish-jobs/job_preview_id", {
  headers: { Authorization: "Bearer YOUR_API_KEY" }
});

Create draft

Prepare source content for review.

Generate caption/tags

Ask AI to prepare platform-specific copy.

Check job status

Read approval state and publishing readiness without provider calls from the landing page.