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

Bulk assign keys to a guardrail

POST
https://openrouter.ai/api/v1/guardrails/:id/assignments/keys
POST
/api/v1/guardrails/:id/assignments/keys
$curl -X POST https://openrouter.ai/api/v1/guardrails/550e8400-e29b-41d4-a716-446655440000/assignments/keys \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json" \
> -d '{
> "key_hashes": [
> "c56454edb818d6b14bc0d61c46025f1450b0f4012d12304ab40aacb519fcbc93"
> ]
>}'
1{
2 "assigned_count": 3
3}

Assign multiple API keys to a specific guardrail. Management key required.

Was this page helpful?
Previous

Bulk unassign keys from 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

Request

This endpoint expects an object.
key_hasheslist of stringsRequired
Array of API key hashes to assign to the guardrail

Response

Assignment result
assigned_countinteger
Number of keys successfully assigned

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
500
Internal Server Error