unauthenticated | 401 | -32001 | No valid sign-in or token was sent, or it expired. | Sign in again with sddvault login, or create a new token. |
forbidden | 403 | -32003 | Your role or the token's access does not allow the action, for example an editor writing the constitution. | Ask a project owner, or use an identity or token with the right access. |
policy | 403 | -32003 | An organization policy or plan limit refused the request. The code is one of the reasons below. | Read the message: it names the policy or limit and how to lift it. |
not_found | 404 | -32002 | The project, spec, document, task or revision does not exist, or you cannot see it; over HTTP also a path that is no API route. | Check the address (organization/project) and the number. |
conflict | 409 | -32602 | The document changed after the revision you based your write on. | Read the current revision (the error carries it), merge and write again. |
claimed | 409 | -32602 | Another agent or person holds the claim on the task. | Pick another task, or wait until the claim is released or expires. |
validation | 422 | -32602 | The input is invalid, malformed or refused, for example an invalid status change or approving a spec with open markers, or a spec number or id in the path that is not a positive whole number. | Read the message: it names the field or the allowed values. |
inherited_principle | 422 | -32602 | A constitution write changes a principle inherited from the organization. | Leave inherited principles as they are and add your own. |
precondition | 409, 410, 413 | -32602 | The state of the target does not allow the request, it is gone, or the body is too large. | Read the message and fix the state before retrying. |
rate_limited | 429 | -32029 | Too many requests in a short time. | Wait the seconds in the Retry-After header, then retry. |
billing | 409, 422 | -32602 | The billing provider is not configured or refused a plan change. | Review the billing details, or contact support. |
identity_provider_refused | 422 | -32602 | The sign-in provider refused a change. | Review the details in the message and retry. |
organization_creation | 410, 409, 503, 422 | -32602 | Creating an organization failed. The code is one of the codes below. | Follow the message and start again if the request expired. |
unavailable | 503 | -32603 | A service SDD Vault depends on is temporarily unavailable. | Retry in a moment. |
internal | 500 | -32603 | Something failed on our side. | Retry; if it persists, contact support. |