# Uygulamanın token'larını iptal et

`POST /v1/applications/{application_id}/tokens:revoke` · izin `sessions:write`

Uygulamaya verilmiş bütün etkin refresh token ailelerini, bütün kullanıcılar için iptal eder. Çağrıdan önce uygulamaya verilmiş access token'lar introspection ve iptal denetiminde artık kabul edilmez. Uygulamaya verilmiş token'lar sızmış olabileceğinde kullanın: uygulama yeni token'ı yeni bir yetkilendirme isteğiyle almak zorundadır.

Oturumlar, kullanıcıların onayları ve uygulamanın kimlik bilgileri değişmez: kullanıcıların giriş oturumları açık kalır, bu yüzden yeni yetkilendirme isteği yeniden giriş yapmadan başarılı olabilir ve onay yeniden istenmez. Sızan bir client sırrının yeni token almasını durdurmak için [uygulamanın kimlik bilgilerini](credentials/create.md) de döndürün. İsteğin gövdesi yoktur. Tekrar çağrı sıfır sayıyla başarılı olur. İptal yönetim audit'ine yazılır. Yeniden denemeleri güvenli kılmak için `Idempotency-Key` başlığı gönderin.

## İstek

| Parametre | Yer | Zorunlu | Açıklama |
|---|---|---|---|
| `application_id` | path | evet | `app_` önekli uygulama kimliği. |

## Yanıt

`200 OK`.

```json
{
  "revoked_token_families": 318
}
```

`revoked_token_families` bu çağrıda iptal edilen refresh token ailesi sayısıdır.

## Hatalar

Her hata, kararlı bir `code` taşıyan `application/problem+json` gövdesidir.

| HTTP | `code` | Ne zaman |
|---|---|---|
| 400 | `malformed_request`, `unknown_field` | Gövde gönderildi ve boş JSON nesnesi değil. |
| 404 | `not_found` | Uygulama bu ortamda yok. |
| 401 | `unauthenticated` | API anahtarı yok, geçersiz ya da iptal edilmiş. |
| 403 | `insufficient_permissions` | Anahtarda `sessions:write` izni yok. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` değerine uyun. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyor; sonra yeniden deneyin. |

## Örnek

```bash
curl -X POST https://api.eu.keenauth.com/v1/applications/app_0a1b2c3d4e5f6g7h8j9k0m1n2p/tokens:revoke \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

CLI: `keenauth applications tokens revoke app_0a1b2c3d4e5f6g7h8j9k0m1n2p --yes`