September 11, 2026
[Breaking + API] One consolidated error envelope across the APIEvery REST API error response now carries
{error, detail, error_code, retryable, request_id}. Branch on error_code; request_id is the sole correlation handle to quote in a support request. (MCP tool errors add a numeric status field, because a tool error travels inside a 200 JSON-RPC response.)Action required: read the machine-readable code from error_code, not a separate code field. There is no reference_id — use request_id. Responses no longer include a params object, and there is no bare { "detail": … } fallback shape; any occurrence-specific value, such as the scope a call is missing, is named in the error sentence. detail stays free-shaped developer diagnostics and may be omitted.See Errors for the full envelope and code reference.