DocsReference
Errors
Errors use standard HTTP status codes and a JSON body:
{
"statusCode": 400,
"message": "title is required",
"error": "Bad Request"
}Status codes
| Code | Meaning |
|---|---|
| 400 | Validation failed (bad input). |
| 401 | Missing, invalid, or revoked API key. |
| 403 | The authenticated user does not own this resource. |
| 404 | Resource not found (or not scoped to your account). |
| 429 | Rate limit exceeded. |
| 500 | Unexpected server error. Please retry with exponential backoff. |
| 503 | Billing not configured (when calling Stripe endpoints). |
Partial publish failures
Publishing a post to multiple platforms is not atomic. A post can transition to partial — meaning some platforms published successfully and others failed. Inspect platformResults on GET /v1/posts/{id} to see each platform's outcome.
Was this page helpful?
Something unclear? Email us — we read every message.