Error handling

The Neuron API uses standard HTTP status codes and returns structured error objects to help you handle failures gracefully.

Error response format

{
  "error": {
    "code": "invalid_request",
    "message": "The 'name' field is required.",
    "requestId": "abc123"
  }
}

Code	Meaning
`200`	Success
`201`	Resource created
`400`	Bad request — check your request body or parameters
`401`	Unauthorized — invalid or missing API key
`403`	Forbidden — insufficient permissions
`404`	Not found — resource does not exist
`422`	Unprocessable entity — validation error
`429`	Too many requests — rate limit exceeded
`500`	Internal server error — contact support

If you exceed the rate limit, you’ll receive a 429 response. The Retry-After header indicates how many seconds to wait before retrying.

For transient errors (500, 503), implement exponential backoff with jitter. Do not retry on 4xx errors without fixing the underlying issue.