# passport_rotation_not_permitted

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

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

<div data-pagefind-ignore>

Since API version `1.1`.

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

</div>

## What it means

A Passport can start a connection rotation at a vendor only when it was linked through a setup-portal link with the `sso` or `edit_connection` intent. Links made through other intents, or before intents were recorded, can show status but cannot open the connection for editing.

## Likely causes

- The Passport was linked from a portal link for domain verification or directory sync only.
- The link was made before intents were recorded.

## How to fix it

### For developers

- Send the IT admin a new portal link with the `sso` or `edit_connection` intent; linking the Passport through it adds rotation rights.

### For IT administrators

- Open the app's setup link for single sign-on again and link your Passport from it, then start the rotation.

## Example

HTTP status 403 when the rotation starts:

```json
{
  "error": {
    "type": "permission",
    "code": "passport_rotation_not_permitted",
    "message": "This Passport link was not enrolled through a portal link with the `sso` or `edit_connection` intent (or was enrolled before intents were recorded), so it cannot start a connection rotation; enrol again through such a portal link",
    "doc_url": "https://docs.ohauthcat.com/errors/passport_rotation_not_permitted",
    "request_id": "req_01J9Z3K5V7W8X9Y0Z1A2B3C4D5"
  }
}
```

## Developer message

This Passport link was not enrolled through a portal link with the `sso` or `edit_connection` intent (or was enrolled before intents were recorded), so it cannot start a connection rotation; enrol again through such a portal link

## IT administrator message

Your Passport can't update this connection. Open the setup link from the app again to get that access

## 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>Ihr Passport kann diese Verbindung nicht aktualisieren. Öffnen Sie den Einrichtungslink der App erneut, um diesen Zugriff zu erhalten</span>
- `es`: <span lang="es" data-pagefind-ignore>Su Passport no puede actualizar esta conexión. Vuelva a abrir el enlace de configuración de la aplicación para obtener ese acceso</span>
- `fr`: <span lang="fr" data-pagefind-ignore>Votre Passport ne peut pas mettre à jour cette connexion. Rouvrez le lien de configuration de l'application pour obtenir cet accès</span>
- `ja`: <span lang="ja" data-pagefind-ignore>Passport ではこの接続を更新できません。アプリのセットアップリンクをもう一度開いて、そのアクセス権を取得してください</span>
- `pt-BR`: <span lang="pt-BR" data-pagefind-ignore>Seu Passport não pode atualizar esta conexão. Abra novamente o link de configuração do aplicativo para obter esse acesso</span>

Security invariants: 52.
