# 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 {#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 {#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 {#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 {#already-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 {#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](/developers/limits). |
| 503 | MapleID cannot reach its database. | Wait for the seconds in `Retry-After`, then try again. |