| Code | Status | Detail |
|---|---|---|
invalid_value | 400 | A request value is invalid. |
unauthenticated | 401 | Authentication is required. |
forbidden | 403 | You do not have permission to perform this action. |
agent_not_found | 404 | Agent not found. |
already_exists | 409 | The resource already exists. |
conflict | 409 | The request conflicts with the current resource state. |
rate_limited | 429 | Too many requests. |
server_error | 500 | Something went wrong. |
bad_gateway | 502 | We couldn’t complete that request because one of Natural’s services returned an unexpected response. Please try again. |
service_unavailable | 503 | The service is temporarily unavailable. |
Resource errors
Agents
Public error codes for Agents API endpoints
All error responses follow the standard error format.
Validation errors (422) and rate limit errors (429) apply to all endpoints and are documented in the Error Handling guide.