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

Bir koruma bariyeri ataması oluşturun

Bir koruma kuralını standart API anahtarına, hesap üyesine veya paylaşılan etiket bütçesine atayın.

Markdown'ı görüntüle

Bir koruma kuralını standart API anahtarına, hesap üyesine veya paylaşılan etiket bütçesine atayın.

Uç Nokta

POST /api/v1/guardrail_assignments
Temel URL
https://runapi.ai
API sürümü
v1
Kimlik doğrulama
Authorization: Bearer YOUR_MANAGEMENT_API_KEY
Yetkilendirme
Hesap yöneticileri uygun herhangi bir hedef atayabilir. Yönetici olmayan kullanıcılar yalnızca kendi Standart API anahtarlarını atayabilir.
02

İstek

JSON gövdesi

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

JSON gövdesi4 alan
account_user_idstring
İsteğe bağlı

Hesap üyesi ön ek kimliği. Bu hedef için hesap yöneticisi gereklidir.

api_token_idstring
İsteğe bağlı

Standart API anahtarı önek kimliği. api_token_id, account_user_id veya tag alanlarından tam olarak birini belirtin.

guardrail_idstring
Zorunlu

Guardrail ön eki kimliği.

tagstring
İsteğe bağlı

Paylaşılan bütçe için büyük/küçük harfe duyarlı key:value etiketi. Hesap yöneticisi ve pozitif sınırlı block modunda bir koruma kuralı gerektirir. Tam olarak bir hedef belirtin.

03

Başarılı yanıt

HTTP 201

POST /api/v1/guardrail_assignments

JSON 
{
  "account_user_id": null,
  "api_token_id": null,
  "created_at": "2026-07-27T10:00:00.000Z",
  "guardrail_id": "guardrail_123",
  "id": "guardrail_assignment_123",
  "tag": "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ı (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"
}
07

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": "Forbidden"
}
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 POST https://runapi.ai/api/v1/guardrail_assignments \
  -H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"guardrail_id":"guardrail_123","tag":"dept:ml"}'