For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
ModelsChatRankingsDocs
DocsAPI ReferenceClient SDKsAgent SDKCookbookChangelog
DocsAPI ReferenceClient SDKsAgent SDKCookbookChangelog
  • API Guides
    • Overview
    • Streaming
    • Embeddings
    • Limits
    • Authentication
    • Parameters
    • Errors and Debugging
  • API Reference
      • GETList guardrails
      • POSTCreate a guardrail
      • GETGet a guardrail
      • DELDelete a guardrail
      • PATCHUpdate a guardrail
      • GETList key assignments for a guardrail
      • POSTBulk assign keys to a guardrail
      • POSTBulk unassign keys from a guardrail
      • GETList member assignments for a guardrail
      • POSTBulk assign members to a guardrail
      • POSTBulk unassign members from a guardrail
      • GETList all key assignments
      • GETList all member assignments
LogoLogo
ModelsChatRankingsDocs
API ReferenceGuardrails

List key assignments for a guardrail

GET
https://openrouter.ai/api/v1/guardrails/:id/assignments/keys
GET
/api/v1/guardrails/:id/assignments/keys
$curl https://openrouter.ai/api/v1/guardrails/550e8400-e29b-41d4-a716-446655440000/assignments/keys \
>     -H "Authorization: Bearer <token>"
1{
2  "data": [
3    {
4      "assigned_by": "user_abc123",
5      "created_at": "2025-08-24T10:30:00Z",
6      "guardrail_id": "550e8400-e29b-41d4-a716-446655440001",
7      "id": "550e8400-e29b-41d4-a716-446655440000",
8      "key_hash": "c56454edb818d6b14bc0d61c46025f1450b0f4012d12304ab40aacb519fcbc93",
9      "key_label": "prod-key",
10      "key_name": "Production Key"
11    }
12  ],
13  "total_count": 1
14}

List all API key assignments for a specific guardrail. Management key required.

Was this page helpful?
Previous

Bulk assign keys to a guardrail

Next
Built with

Authentication

AuthorizationBearer
API key as bearer token in Authorization header

Path parameters

idstringRequiredformat: "uuid"
The unique identifier of the guardrail

Query parameters

offsetintegerOptional>=0
Number of records to skip for pagination
limitintegerOptional1-100

Maximum number of records to return (max 100)

Response

List of key assignments
datalist of objects
List of key assignments
total_countinteger
Total number of key assignments for this guardrail

Errors

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error