Skip to Content
API ReferenceGuardrailsBulk Unassign Keys From Guardrail

Bulk unassign keys from a guardrail

POST

https://novapai.ai/api/v1/guardrails/:id/assignments/keys/remove 

POST

/api/v1/guardrails/:id/assignments/keys/remove

cURL
$curl -X POST https://novapai.ai/api/v1/guardrails/550e8400-e29b-41d4-a716-446655440000/assignments/keys/remove \ >-H "Authorization: Bearer <token>" \ >-H "Content-Type: application/json" \ >-d '\{ >"key_hashes": [ >"c56454edb818d6b14bc0d61c46025f1450b0f4012d12304ab40aacb519fcbc93" >] >\}'
200 Successful
reference-guardrails-bulk-unassign-keys-from-guardrail-01.json
{ "unassigned_count": 3 }

Unassign multiple API keys from a specific guardrail. Management key  required.

Authentication

Authorization Bearer

API key as bearer token in Authorization header

Path parameters

id string Requiredformat: "uuid"

The unique identifier of the guardrail

Request

This endpoint expects an object.

字段类型必填说明
key_hasheslist of stringsArray of API key hashes to unassign from the guardrail

Response

Unassignment result

字段类型必填说明
unassigned_countdouble-Number of keys successfully unassigned

Errors

状态码说明
400Bad Request Error
401Unauthorized Error
404Not Found Error
500Internal Server Error