---
title: "List key assignments for a guardrail"
method: GET
path: "/guardrails/{id}/assignments/keys"
tags: ["Guardrails"]
---

# List key assignments for a guardrail

`GET /guardrails/{id}/assignments/keys`

List all API key assignments for a specific guardrail. [Management key](/docs/guides/overview/auth/management-api-keys) required.

## Path parameters

- `id` string, uuid, required — The unique identifier of the guardrail

## Query parameters

- `offset` integer, nullable — Number of records to skip for pagination
- `limit` integer — Maximum number of records to return (max 100)

## Response `200`

List of key assignments

- ListKeyAssignmentsResponse
  - `data` KeyAssignment[], required — List of key assignments
    - `assigned_by` string, nullable, required — User ID of who made the assignment
    - `created_at` string, required — ISO 8601 timestamp of when the assignment was created
    - `guardrail_id` string, uuid, required — ID of the guardrail
    - `id` string, uuid, required — Unique identifier for the assignment
    - `key_hash` string, required — Hash of the assigned API key
    - `key_label` string, required — Label of the API key
    - `key_name` string, required — Name of the API key
  - `total_count` integer, required — Total number of key assignments for this guardrail

## Other responses

- `401` — Unauthorized - Authentication required or invalid credentials
- `404` — Not Found - Resource does not exist
- `500` — Internal Server Error - Unexpected server error

---

[API](https://skmtc.net/openrouterteam/apis/openrouter-api.md) · [All operations](https://skmtc.net/openrouterteam/apis/openrouter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openrouterteam/openrouter-api/versions/4836d63be710/schema)