Errors
Common HTTP and JSON-RPC error shapes.
Errors
REST
Error responses typically look like:
{
"error": "Unauthorized"
}| Status | Meaning |
|---|---|
400 | Validation failed (missing/invalid domain, body, etc.) |
401 | Missing/invalid API key or internal auth |
404 | Unknown route or resource |
429 | Rate limited — back off and retry |
5xx | Unexpected server error |
MCP (JSON-RPC)
MCP errors use JSON-RPC envelopes, for example:
{
"jsonrpc": "2.0",
"error": { "code": -32001, "message": "Unauthorized" },
"id": null
}Method-not-allowed (GET/DELETE on /mcp) returns 405 with Allow: POST.