List policies

Returns a paginated list of policies in a gateway.

GET /v1/gateways/{gateway_id}/policies

Error

A valid request URL is required to generate request examples

200

{
  "items": [
    {
      "consumer_ids": [
        "<string>"
      ],
      "created_at": "<string>",
      "description": "<string>",
      "enabled": true,
      "gateway_id": "<string>",
      "global": true,
      "id": "<string>",
      "mcp_scope": {
        "except_groups": [
          "<string>"
        ],
        "groups": [
          "<string>"
        ],
        "registry_ids": [
          "<string>"
        ],
        "tools": [
          {
            "registry_id": "<string>",
            "tool": "<string>"
          }
        ]
      },
      "mcp_wide": true,
      "mode": "<string>",
      "name": "<string>",
      "parallel": true,
      "priority": 123,
      "settings": {},
      "slug": "<string>",
      "stages": [
        "<string>"
      ],
      "status": "active",
      "status_message": "<string>",
      "updated_at": "<string>",
      "warnings": [
        "<string>"
      ]
    }
  ],
  "page": 123,
  "size": 123,
  "total": 123
}

Authorizations

Authorization · string · header · required

Path Parameters

gateway_id · string<uuid> · required

Gateway id

Query Parameters

search · string

Substring match on name or slug (alias: name)

name · string

Alias of search

enabled · boolean

Filter by enabled flag

global · boolean

Filter by global flag; global=false also lists MCP-wide policies

mode · string

Filter by mode (enforce, throttle, observe)

category · string

Catalog category (group type); comma-separated multi

type · string

Plugin slug (FE type filter); comma-separated multi

registry_id · string<uuid>

Only policies whose mcp_scope names this registry (in registry_ids or tools)

sort · string

Sort field (name, created_at, updated_at, priority)

order · string

Sort order (asc, desc)

page · integer

Page number (1-based)

size · integer

Page size

Response

200

application/json

OK

items · object[]

Show child attributes

page · integer

size · integer

total · integer