Getting started
Errors
Failures use standard HTTP status codes and always return the same JSON shape:
Error response
{
"error": {
"code": "not_found",
"message": "Post not found.",
"status": 404
}
}| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request, invalid_id, missing_* | Something in the request is wrong. The message says what. |
| 401 | unauthorized | Missing or invalid API key. |
| 402 | plan_required | The workspace has no active Creator OS plan. |
| 403 | forbidden | The key can’t act on this resource. |
| 403 | insufficient_scope | The key or connection is read only and the request would change something. |
| 404 | not_found | The resource or endpoint doesn’t exist. |
| 409 | workspace_not_ready, conflict | The workspace isn’t set up yet, or the request conflicts with current state. |
| 415 | unsupported_media | That file type isn’t accepted by the networks. |
| 429 | rate_limited | A network is rate limiting this account. Retry later. |
| 502 / 503 | upstream_error, service_unavailable | A network or our publishing service had a problem. Safe to retry. |