Errors

HTTP Status Codes

Status	Meaning
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
409	Conflict
422	Validation Error
429	Too Many Requests
500	Internal Server Error

Error Payload Example

{
  "error": {
    "code": "validation_error",
    "message": "The request payload is invalid.",
    "details": []
  }
}

Recommendations

• Validate payloads before sending requests.
• Handle 401 by refreshing the token and retrying.
• Handle 429 with retry/backoff logic.
• Log request/response metadata for troubleshooting.