List guardrails

GET

/api/v1/guardrails

cURL


$curl https://novapai.ai/api/v1/guardrails \
>-H "Authorization: Bearer <token>"

200 Retrieved

reference-guardrails-list-guardrails-01.json


{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Production Guardrail",
      "created_at": "2025-08-24T10:30:00Z",
      "description": "Guardrail for production environment",
      "limit_usd": 100,
      "reset_interval": "monthly",
      "allowed_providers": ["openai", "anthropic", "google"],
      "enforce_zdr": false,
      "updated_at": "2025-08-24T15:45:00Z"
    }
  ],
  "total_count": 1
}

List all guardrails for the authenticated user. Management key required.

Authentication

Authorization Bearer

API key as bearer token in Authorization header

Query parameters

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

Response

List of guardrails

字段	类型	必填	说明
data	list of objects	-	List of guardrails
total_count	double	-	-
Total	number of guardrails	-	-

Errors

状态码	说明
401	Unauthorized Error
500	Internal Server Error