Skip to main content

API Key Güncelle

API anahtarı bilgilerini günceller.

Endpoint

PUT /api/v1/api-keys/\{uuid\}
PATCH /api/v1/api-keys/\{uuid\}

Authentication

Bu endpoint authentication gerektirir.

Header: Authorization: Bearer \{token\}

Permission

  • api.keys.update - Tüm API anahtarlarını güncelleme
  • api.keys.update.own - Sadece kendi API anahtarlarını güncelleme

Request

Headers

HeaderDeğerZorunlu
AuthorizationBearer \{token\}Evet
Content-Typeapplication/jsonEvet

Path Parameters

ParametreTipZorunluAçıklama
uuidstringEvetAPI key UUID'si

Request Body

ParametreTipZorunluAçıklama
namestringHayırAPI key adı
expires_atdatetimeHayırSon kullanma tarihi
permissionsarrayHayırİzin listesi
metadataobjectHayırEk metadata bilgileri (JSON)
is_activebooleanHayırAktif durumu

Example Request

{
"name": "Updated Production API Key",
"expires_at": "2027-12-31T23:59:59.000000Z",
"is_active": true
}

Response

Success Response (200 OK)

{
"id": 1,
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"name": "Updated Production API Key",
"expires_at": "2027-12-31T23:59:59.000000Z",
"is_active": true,
"updated_at": "2025-11-20T12:00:00.000000Z"
}

Error Responses

404 Not Found

{
"message": "Not Found"
}

403 Forbidden

{
"message": "Forbidden"
}

Code Examples

cURL

curl -X PATCH https://api.example.com/api/v1/api-keys/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer \{token\}" \
-H "Content-Type: application/json" \
-d '{
"name": "Updated Production API Key",
"expires_at": "2027-12-31T23:59:59.000000Z"
}'

Notes

  • .own permission'ı olan kullanıcılar sadece kendi anahtarlarını güncelleyebilir
  • PUT tüm alanları günceller, PATCH sadece gönderilen alanları günceller
  • API key'in kendisi değiştirilemez, sadece metadata ve ayarlar güncellenebilir