# plan_limit_reached

<!-- Generated by scripts/generate.ts. Do not edit. -->

<!-- Source: core commit `f70874a3916ad5b24a8619246cbae6cc8bc24d27`. -->

<div data-pagefind-ignore>

Since API version `1.0`.

| Field     | Value           |
| --------- | --------------- |
| Type      | `permission`    |
| Status    | 403             |
| Surfaces  | `api`, `portal` |
| Retryable | No              |

</div>

## What it means

The project's plan does not include this feature, or allows no more of it. The message names the feature or limit and the lowest plan that has it. `param` names the field or limit when there is one, including the enforced monthly limits `monthly_active_users`, `audit_log_events` and `pipes_token_fetches`. Existing resources and existing users keep working.

## Likely causes

- The request uses a feature that the current plan does not include.
- The project already has as many of this resource as its plan allows.
- An enforced monthly limit was reached, so growth (new users, audit log events, Pipes token fetches) is refused until the next period or an upgrade.

## How to fix it

### For developers

- Read `message` for the plan that has the feature, then upgrade the project in the dashboard or remove resources you no longer use.
- Treat this error as final for the request; retrying does not help until the plan or usage changes.

### For IT administrators

- Ask the app's team to upgrade their plan.

## Example

HTTP status 403 when a project on the Pro plan sets email colors:

```json
{
  "error": {
    "type": "permission",
    "code": "plan_limit_reached",
    "message": "Email colors need the Business plan or above",
    "param": "surfaces.email.colors",
    "doc_url": "https://docs.ohauthcat.com/errors/plan_limit_reached",
    "request_id": "req_01J9Z3K5V7W8X9Y0Z1A2B3C4D5"
  }
}
```

## Developer message

The project's plan doesn't include this feature or allows no more of it. The message names the feature or limit and the plan that unlocks it, and `param` the field or limit when there is one (for the enforced monthly limits monthly_active_users, audit_log_events or pipes_token_fetches); `doc_url` explains upgrades. Existing resources and existing users keep working

## IT administrator message

The app's plan doesn't include this or allow more of it. Ask the app's team to upgrade

## Translated IT administrator messages

The hosted portal shows these machine translations, which native speakers have not reviewed yet. Placeholders and identity provider console labels stay in English.

- `de`: <span lang="de" data-pagefind-ignore>Der Tarif der App umfasst dies nicht oder erlaubt nicht mehr davon. Bitten Sie das Team der App um ein Upgrade</span>
- `es`: <span lang="es" data-pagefind-ignore>El plan de la aplicación no incluye esto o no permite más. Pida al equipo de la aplicación que mejore el plan</span>
- `fr`: <span lang="fr" data-pagefind-ignore>L'offre de l'application n'inclut pas cette fonctionnalité ou n'en permet pas davantage. Demandez à l'équipe de l'application de passer à une offre supérieure</span>
- `ja`: <span lang="ja" data-pagefind-ignore>アプリのプランにはこの機能が含まれていないか、これ以上追加できません。アプリのチームにアップグレードを依頼してください</span>
- `pt-BR`: <span lang="pt-BR" data-pagefind-ignore>O plano do aplicativo não inclui isto ou não permite mais. Peça à equipe do aplicativo para fazer upgrade</span>
