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

Güvenlik bariyerini güncelle

Bu paylaşılan politikayı kullanan tüm atamalar için sağlanan alanları değiştirin. Atlanan alanlar değişmez.

Markdown'ı görüntüle

Bu paylaşılan politikayı kullanan tüm atamalar için sağlanan alanları değiştirin. Atlanan alanlar değişmez.

Uç Nokta

PATCH /api/v1/guardrails/: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.
02

İstek

JSON gövdesi

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

JSON gövdesi12 alan
alert_threshold_percentinteger
İsteğe bağlı

Bütçe uyarı eşiği yüzdesi.

Varsayılan: 80 Aralık: 1 - 100
allowed_modelsarray | null
İsteğe bağlı

Yeni model izin verilenler listesi.

allowed_providersarray | null
İsteğe bağlı

Yeni sağlayıcı adı izin verilenler listesi.

blocked_modelsarray | null
İsteğe bağlı

Yeni model engellenenler listesi.

blocked_providersarray | null
İsteğe bağlı

Yeni sağlayıcı adı engellenenler listesi.

credit_limit_behaviorstring
İsteğe bağlı

Bütçe uygulama modu. Etiket atamaları block gerektirir.

İzin verilen değerler: block, alert_only Varsayılan: block
credit_limit_centsinteger | null
İsteğe bağlı

USD cent cinsinden toplam harcama limiti.

credit_limit_reset_intervalstring | null
İsteğe bağlı

Toplam harcama sınırı sıfırlama dönemi. Tutar ayarlanmışsa Null ömür boyu anlamına gelir.

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

Yeni serbest biçimli açıklama.

enabledboolean
İsteğe bağlı

Koruyucunun uygulanıp uygulanmadığı.

model_budgetsarray | null
İsteğe bağlı

Yeni model başına bütçe kuralları.

namestring
İsteğe bağlı

Yeni güvenlik duvarı adı.

Yol parametreleri1 alan
idstring
Zorunlu

Guardrail ön eki kimliği; örneğin guardrail_abc123.

03

Başarılı yanıt

HTTP 200

PATCH /api/v1/guardrails/:id

JSON 
{
  "alert_threshold_percent": 80,
  "allowed_models": [
    "gpt-5.4"
  ],
  "allowed_providers": [],
  "assignment_count": 1,
  "blocked_models": [],
  "blocked_providers": [],
  "created_at": "2026-07-27T10:00:00.000Z",
  "credit_limit_behavior": "block",
  "credit_limit_cents": 50000,
  "credit_limit_reset_interval": "monthly",
  "description": "Production policy",
  "enabled": false,
  "id": "guardrail_123",
  "model_budgets": [
    {
      "credit_limit_cents": 10000,
      "credit_limit_reset_interval": "monthly",
      "match_mode": "include",
      "models": [
        "gpt-5.4"
      ]
    }
  ],
  "name": "Production budget"
}
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/guardrails/guardrail_123 \
  -H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"enabled":false}'