API Reference

List guardrail assignments

List assignments visible to the authenticated management key.

View Markdown

List assignments visible to the authenticated management key.

GET /api/v1/guardrail_assignments

Base URL: https://runapi.ai
API version: v1
Authentication: Authorization: Bearer YOUR_MANAGEMENT_API_KEY
Authorization: Account admins can view all assignments; non-admin users can view assignments on their own API keys.

Request

JSON body

Send values only in the listed request location.

Query parameters2 fields

limitinteger

Optional

Maximum assignments returned per page.

Default: 20 Range: 1 - 100

pageinteger

Optional

Offset page number. Values start at 1.

Default: 1 Bound: 1

Success response

HTTP 200

GET /api/v1/guardrail_assignments

JSON

{
  "guardrail_assignments": [
    {
      "account_user_id": null,
      "api_token_id": "token_123",
      "created_at": "2026-07-27T10:00:00.000Z",
      "guardrail_id": "guardrail_123",
      "id": "guardrail_assignment_123"
    }
  ],
  "pagination": {
    "limit": 20,
    "page": 1,
    "pages": 1,
    "total": 1
  }
}

Error response (401)

HTTP 401

JSON

{
  "error": "Authentication required"
}

Error response (403)

HTTP 403

JSON

{
  "error": "Management API key required"
}

Error response (400)

HTTP 400

JSON

{
  "error": "page must be an integer"
}

cURL example

CURL

curl -X GET https://runapi.ai/api/v1/guardrail_assignments?page=1&limit=20 \
  -H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY'

List guardrail assignments

Endpoint

Request

Success response

Error response (401)

Error response (403)

Error response (400)

cURL example

Related reference