{
  "data": {
    "id": "Fq2xWnA0kLpR7sVtYu3zc",
    "status": "draft",
    "scheduled_for": null,
    "parts": [
      {
        "text": "Rough idea: why most scheduling tools get threads wrong."
      }
    ],
    "title": "Launch teaser v2",
    "scratchpad": null,
    "tags": [],
    "created_at": "2026-07-05T20:11:00.000Z"
  }
}

{
  "error": {
    "code": "invalid_media",
    "message": "Unknown object_key: u123/api_..._chart.png. Upload media first via POST /v1/media."
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Unknown or revoked API key"
  }
}

{
  "error": {
    "code": "insufficient_scope",
    "message": "This API key is read-only. Create a key with the write scope to use this endpoint."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "No scheduled post with that id belongs to this account."
  }
}

{
  "error": {
    "code": "post_not_editable",
    "message": "Only drafts and scheduled posts can be edited."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded for the Pro plan (30 requests/min). Upgrade for higher limits.",
    "retry_after": 42
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Failed to fetch scheduled posts. Try again shortly."
  }
}

{
  "error": {
    "code": "upstream_unavailable",
    "message": "The scheduling service is temporarily unavailable. Retry with the same Idempotency-Key."
  }
}