# Revoke Federation Keys

`POST /crypto/federation-keys/revoke` · Core · Encryption

Revokes every federation signing key of the project: tokens already issued stop verifying once your cloud's cached copy of the key set expires, and the next token is signed with a new key under the same issuer URL. Requires a project admin's session and a step-up; audited.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `projectSlug` | path | yes | The project's slug: the path segment after `@`. It is unique within the org. Example: `"storefront"`. |

## Responses

- **200**: Success

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | object | yes | The outcome of the revocation. |
| `data.revokedKids` | array of string | yes | The key ids of the project's federation signing keys that were revoked. A key stops being published in the project's federation key set. Empty when the project had no federation key. The next token issued creates a fresh key. |
| `meta` | object | yes |  |


## Errors

| HTTP | Code | When |
|---|---|---|
| 401 | `K9O_UNAUTHENTICATED` | The caller is not authenticated. |
| 403 | `K9O_EXTENSION_PERMISSION_DENIED` | Extensions use k9o.kibo, not the crypto resource. |
| 401 | `K9O_STEP_UP_REQUIRED` | Revoking needs a fresh step-up. |
| 403 | `K9O_RBAC_DENY` | Only a project admin's session can revoke the federation keys. |
| 503 | `K9O_KEY_SERVICE_UNAVAILABLE` | The key service could not revoke; nothing changed. |

## Code samples

### cURL

```bash
curl -X POST 'https://<org>.api-<region>.k9o.io/@storefront/crypto/federation-keys/revoke' \
  -H 'Authorization: Bearer $K9O_TOKEN'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/crypto/federation-keys/revoke', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`
  },
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/core/revoke-federation-keys
