İçeriğe geç
API Referansı
API Referansı

Bir API anahtarını güncelle

Mevcut bir Standart API anahtarını güncelleyin ve güncel kullanım özetini alın.

Markdown'ı görüntüle

Mevcut bir Standart API anahtarını güncelleyin ve güncel kullanım özetini alın.

Uç Nokta

PATCH /api/v1/keys/:id
Temel URL
https://runapi.ai
API sürümü
v1
Kimlik doğrulama
Authorization: Bearer YOUR_MANAGEMENT_API_KEY
Yetkilendirme
Hesap yöneticisi Yönetim API anahtarı gerektirir ve yalnızca kullanıcısına ait anahtarlara izin verir.
02

İstek

JSON gövdesi

Değerleri yalnızca listelenen istek konumunda gönderin.

JSON gövdesi7 alan
allowed_modelsarray | null
İsteğe bağlı

Yeni model izin verilenler listesi; null veya boş bir dizi listeyi temizler.

credit_limit_centsinteger | null
İsteğe bağlı

USD cent cinsinden harcama tavanı; null değeri tavanı ve sıfırlama aralığını kaldırır.

credit_limit_reset_intervalstring | null
İsteğe bağlı

Harcama sınırı için sıfırlama aralığı.

İzin verilen değerler: daily, weekly, monthly
credit_limit_windowsobject
İsteğe bağlı

1h, 1d veya 7d anahtarlarıyla belirtilen yeni dönen harcama limitleri; boş bir nesne tüm dönen limitleri temizler.

enabledboolean
İsteğe bağlı

Bu anahtarı kullanan isteklerin kabul edilip edilmediği.

namestring
İsteğe bağlı

API anahtarı için yeni kolay ad.

tagsarray
İsteğe bağlı

Yerine geçecek key:value dizeleri; atlamak etiketleri korur. Oluşturmayla aynı biçim ve 20 etiket sınırı geçerlidir. usage yoksa usage:developer olur; boş dizi usage:developer değerine sıfırlar.

Yol parametreleri1 alan
idstring
Zorunlu

API anahtarı ön ek kimliği; örneğin token_123.

03

Başarılı yanıt

HTTP 200

PATCH /api/v1/keys/:id

JSON 
{
  "allowed_models": [
    "gpt-5.4"
  ],
  "created_at": "2026-07-27T10:00:00.000Z",
  "credit_limit_cents": 1000,
  "credit_limit_reset_interval": "daily",
  "credit_limit_windows": {},
  "credit_usage_cents_by_model": {
    "gpt-5.4": 250
  },
  "credit_usage_cents_this_month": 250,
  "credit_usage_cents_this_week": 100,
  "credit_usage_cents_today": 25,
  "credit_usage_cents_total": 250,
  "enabled": true,
  "guardrail_id": "guardrail_123",
  "id": "token_123",
  "last_used_at": null,
  "masked_token": "runapi_abc...wxyz",
  "name": "Production primary",
  "tags": [
    "usage:service",
    "env:production",
    "dept:ml"
  ]
}
04

Hata yanıtı (401)

HTTP 401
Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Authentication required"
}
05

Hata yanıtı (403)

HTTP 403
Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Management API key required"
}
06

Hata yanıtı (403)

HTTP 403
Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Account admin required"
}
07

Hata yanıtı (400)

HTTP 400
Yanıt şeması
JSON 
{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "İnsan tarafından okunabilir hata mesajı.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "İnsan tarafından okunabilir doğrulama özeti.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Herkese açık istek alanına göre anahtarlanan doğrulama mesajları; her alan için insan tarafından okunabilir dizelerden oluşan bir dizi içerir.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Yanıt örneği

JSON 
{
  "error": "page must be an integer"
}
08

Hata yanıtı (404)

HTTP 404
Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Resource not found"
}
09

Hata yanıtı (422)

HTTP 422
Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir doğrulama özeti.",
      "type": "string"
    },
    "errors": {
      "additionalProperties": {
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "description": "Herkese açık istek alanına göre anahtarlanan doğrulama mesajları; her alan için insan tarafından okunabilir dizelerden oluşan bir dizi içerir.",
      "type": "object"
    }
  },
  "required": [
    "error",
    "errors"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Validation failed",
  "errors": {
    "base": [
      "Validation failed"
    ]
  }
}
10

cURL örneği

CURL 
curl -X PATCH https://runapi.ai/api/v1/keys/token_123 \
  -H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Production primary","tags":["usage:service","env:production","dept:ml"],"enabled":true,"credit_limit_windows":{}}'