Guardrails

List key assignments for a guardrail

Changed on

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

get/guardrails/{id}/assignments/keys

Request

  • Base URL: https://openrouter.ai/api/v1
  • URL: https://openrouter.ai/api/v1/guardrails/{id}/assignments/keys
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The unique identifier of the guardrail

Example:550e8400-e29b-41d4-a716-446655440000

Query parameters

offsetinteger nullable

Number of records to skip for pagination

limitinteger

Maximum number of records to return (max 100)

Example:50

Response

List of key assignments

total_countinteger required

Total number of key assignments for this guardrail

Example response

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

Changes

  • 9814733ca74dRevision changes
    • breaking

      for the query request parameter limit, default value 50 was added

    • breaking

      for the query request parameter offset, default value 0 was added