{
  "data": {
    "id": "V1StGXR8_Z5jdHi6B-myT",
    "status": "scheduled",
    "scheduled_for": "2026-07-08T15:00:00.000Z",
    "parts": [
      {
        "text": "Shipping day."
      }
    ],
    "title": null,
    "scratchpad": null,
    "tags": [],
    "created_at": "2026-07-06T10:00: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": "writes_main_account_only",
    "message": "The API can only create posts for your main account for now."
  }
}

{
  "error": {
    "code": "account_not_found",
    "message": "No account with that id belongs to this key"
  }
}

{
  "error": {
    "code": "idempotency_key_reuse",
    "message": "This Idempotency-Key was already used with a different request body."
  }
}

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

{
  "error": {
    "code": "internal_error",
    "message": "Failed to fetch posts"
  }
}

{
  "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."
  }
}