List key assignments for a guardrail

GET

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

GET

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

cURL


$curl https://novapai.ai/api/v1/guardrails/550e8400-e29b-41d4-a716-446655440000/assignments/keys \
>-H "Authorization: Bearer <token>"

200 Retrieved

reference-guardrails-list-guardrail-key-assignments-01.json


{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "key_hash": "c56454edb818d6b14bc0d61c46025f1450b0f4012d12304ab40aacb519fcbc93",
      "guardrail_id": "550e8400-e29b-41d4-a716-446655440001",
      "key_name": "Production Key",
      "key_label": "prod-key",
      "assigned_by": "user_abc123",
      "created_at": "2025-08-24T10:30:00Z"
    }
  ],
  "total_count": 25
}

List all API key assignments for 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

Query parameters

字段	类型	必填	说明
offset	string	否	Number of records to skip for pagination
limit	string	否	-
Maximum	number of records to return (max 100)	-	-

Response

List of key assignments

字段	类型	必填	说明
data	list of objects	-	List of key assignments
total_count	double	-	-
Total	number of key assignments for this guardrail	-	-

Errors

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