Errors
MapleID sends errors as RFC 9457 problem JSON. The type field names the problem. Each type URL opens the section of this page for that type.
Agent client inactive
Status: 401. Type: https://mapleid.ca/problems/agent-client-inactive.
An owner or admin disabled the agent client, or the owner archived its organization. New tokens and refresh tokens do not work for it.
What to do: Stop. Ask an owner or admin of the organization for a new agent client.
Consent required
Status: 403. Type: https://mapleid.ca/problems/consent-required.
The access token does not have the scope that the operation needs, or the person removed the consent.
What to do: Send the person through sign-in again, with the scope in the request.
Human action required
Status: 403. Type: https://mapleid.ca/problems/human-action-required.
The action is a page-only action, for example a payment. The problem body has the URL of the page.
What to do: Give the URL to the person. Do not try the action again.
Already a member
Status: 409. Type: https://mapleid.ca/problems/already-member.
The person already has a membership in the organization.
What to do: Do not invite the person again.
Already invited
Status: 409. Type: https://mapleid.ca/problems/already-invited.
An invitation to this address waits for the person.
What to do: Wait for the person, or revoke the open invitation and send a new one.
Errors without a type
| Status | Meaning | What to do |
|---|---|---|
401 invalid_token | The token is missing, expired or not from MapleID. The WWW-Authenticate header has resource_metadata. | Refresh the token, or sign in again. |
403 insufficient_scope | The token does not have the scope of the MCP tool. The WWW-Authenticate header names the scope. | Sign in again with that scope. |
| 403 | The person is not a member of the organization of the agent client. | Stop. Ask an owner or admin to invite the person. |
| 404 | The object does not exist, or it belongs to another organization. | Use the IDs that the API gives you. |
| 422 | A field is not valid, or an Idempotency-Key came with another request. | Read errors in the body and fix the request. |
| 429 | A rate limit stopped the request. | Wait for the seconds in Retry-After. See Limits. |
| 503 | MapleID cannot reach its database. | Wait for the seconds in Retry-After, then try again. |