API Errors

Understanding and handling API error responses.

Error format

All API errors return a JSON body with success: false and a message field.

json

{
  "success": false,
  "message": "Instance not found",
  "errors": null
}

Code	Meaning	Common cause
200	OK	Request succeeded
201	Created	Resource created successfully
400	Bad Request	Missing or invalid request body fields
401	Unauthorized	Missing or invalid Bearer token
403	Forbidden	Token lacks required scope/permission
404	Not Found	Resource does not exist or was deleted
429	Too Many Requests	Rate limit exceeded — back off and retry
500	Internal Server Error	Contact support if this persists

Was this article helpful?