● Reference
Errors.
One envelope, seven codes. Four transport, three domain gates. The gates are the moat: they encode legal and compliance reality and they never soft-pass.
{
"error": {
"code": "authority_required",
"message": "No granted authority model on matter mtr_4Fa1.",
"md_request_id": "req_01JX4M..."
}
}
| Code | HTTP | Meaning | Class |
|---|---|---|---|
| invalid_request | 400 | Malformed body, unknown field, or failed validation. | transport |
| unauthenticated | 401 | Missing or invalid API key. | transport |
| insufficient_scope | 403 | Key lacks the scope this operation requires. | transport |
| rate_limited | 429 | Too many requests; honor Retry-After. | transport |
| authority_required | 403 | No granted authority model on the parent matter. Never soft-passes. | domain gate |
| sanctions_gate | 403 | A sanctions screen hit blocks this operation pending review. | domain gate |
| stay_in_effect | 409 | An enforcement stay is in effect for this matter. | domain gate |