> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Anahtar Revoke / Silme

> Bir anahtarı pasife alma veya kalıcı silme.

Bir anahtarı geçici (**pasif**) veya kalıcı olarak (**sil**) iptal edebilirsiniz. Her iki durumda da o anahtarla yeni token alınamaz, mevcut token süresi dolduğunda da yenilenemez.

## Endpoint'ler

| İşlem      | Endpoint                                                    | Geri alınabilir mi?                   |
| ---------- | ----------------------------------------------------------- | ------------------------------------- |
| Pasife al  | `PUT /api/v1/tenants/me/api-keys/{id}` (`is_active: false`) | Evet — yeniden aktive edilebilir      |
| Kalıcı sil | `DELETE /api/v1/tenants/me/api-keys/{id}`                   | Hayır — OAuth client kaydı da silinir |

Bearer access token + `tenant-admin` rolü gerektirir.

## Pasife alma

```bash theme={null}
curl -X PUT https://identity.payven.com.tr/api/v1/tenants/me/api-keys/8e3f5c12-... \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name":  "Production — Ödeme Servisi",
    "contact_email": "ops@example.com",
    "is_active":     false
  }'
```

Pasife alma **anında etkilidir** — yeni token üretimi durur. Mevcut token'lar süre sonuna kadar (5dk) çalışır, sonra refresh edilemez.

Geri aktive etmek için `is_active: true` ile aynı endpoint:

```bash theme={null}
curl -X PUT https://identity.payven.com.tr/api/v1/tenants/me/api-keys/8e3f5c12-... \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name":  "Production — Ödeme Servisi",
    "contact_email": "ops@example.com",
    "is_active":     true
  }'
```

<Note>
  PUT, PATCH değildir — tüm güncellenebilir alanları göndermeniz gerekir. Sadece `is_active` field'ını
  göndermek diğer alanları sıfırlar. Anlık aktive/pasif için aynı objeyi alıp tek alanı değiştirin.
</Note>

## Kalıcı silme

```bash theme={null}
curl -X DELETE https://identity.payven.com.tr/api/v1/tenants/me/api-keys/8e3f5c12-... \
  -H "Authorization: Bearer $PAYVEN_TOKEN"
```

`204 No Content` — gövde yok.

<Warning>
  Silme **geri alınamaz**. Identity kaydı ve OAuth client kaydı birlikte silinir. `client_id` değeri tekrar üretilmez — yeni bir anahtar oluşturmanız gerekir.
</Warning>

## Ne zaman pasife alın, ne zaman silin?

| Durum                                              | Önerilen aksiyon                                  |
| -------------------------------------------------- | ------------------------------------------------- |
| Anahtarın kullanılmadığını doğrulamak istiyorsunuz | **Pasife al** — birkaç hafta izleyip sonra silin  |
| Sızıntı şüphesi var                                | **Pasife al** (anlık etki) → soruşturma → **sil** |
| Geçici servis kapatılıyor                          | **Pasife al**                                     |
| Eski entegrasyon kalıcı kaldırıldı                 | **Sil**                                           |
| Otomatik temizlik (CI/CD ile)                      | **Sil** — pasifleri bekletmeyin, audit kirletir   |

## Hata response'ları

| HTTP  | `code`              | Anlam                                                                                  |
| ----- | ------------------- | -------------------------------------------------------------------------------------- |
| `404` | `api_key_not_found` | Anahtar bulunamadı                                                                     |
| `403` | `forbidden`         | `tenant-admin` rolü yok                                                                |
| `409` | `api_key_in_use`    | Sistem kritik anahtarı (örn. last-active) silmeyi engelliyor — önce yeni anahtar yarat |

## Audit log

Tüm anahtar yaşam döngüsü olayları konsoldaki **API Kayıtları → Audit** ekranında loglanır:

* Oluşturma (`api_key.created`)
* Güncelleme (`api_key.updated`)
* Rotasyon (`api_key.secret_rotated`)
* Pasife alma / aktif etme (`api_key.deactivated` / `api_key.activated`)
* Silme (`api_key.deleted`)
* Kullanım — her token üretimi (`api_key.used`)

Bu kayıtlar PCI-DSS, ISO 27001 ve KVKK denetimlerinde audit trail olarak kullanılabilir.