Error Codes

HTTP status codes, error response formats, and troubleshooting guidance.

Error Response Format

All error responses follow a consistent JSON format:

{
  "error": "Error Type",
  "status": 400
}

HTTP Status Codes

400Bad RequestInvalid request body or missing required parameters

Invalid request body or missing required parameters

{ "error": "Bad Request", "status": 400 }

401UnauthorizedMissing, invalid, expired, or revoked API key

Missing, invalid, expired, or revoked API key

{ "error": "Unauthorized", "status": 401 }

403ForbiddenNot a member of the workspace or insufficient permissions

Not a member of the workspace or insufficient permissions

{ "error": "Forbidden", "status": 403 }

404Not FoundResource not found or doesn't belong to your workspace

Resource not found or doesn't belong to your workspace

{ "error": "Not Found", "status": 404 }

429Too Many RequestsRate limit exceeded, wait and retry

Rate limit exceeded, wait and retry

{ "error": "Too Many Requests", "status": 429 }

500Internal ErrorServer error, contact support if persistent

Server error, contact support if persistent

{ "error": "Internal Server Error", "status": 500 }

Success Responses

200

Successful GET, PATCH, or DELETE request

201

Created

Successful POST request that created a new resource

204

No Content

Successful request with no response body (e.g., mark all read)

Troubleshooting

For 500 errors, check the status page for ongoing incidents before contacting support.