---
title: "List endpoint permissions (admin)"
method: GET
path: "/admin/endpoint-permissions"
tags: ["admin"]
---

# List endpoint permissions (admin)

`GET /admin/endpoint-permissions`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/admin/endpoint-permissions`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

Returns endpoint_permissions rows with pagination, optionally filtered by module, is_active, and action (req 1). Each item includes updated_at for optimistic concurrency checking in the UI.

## Query parameters

- `module` 'orchestrator' | 'tools' | 'rules' | 'issues' | 'public': Logical API module derived from path_pattern prefixes. Maps to the router mount prefixes defined in main.py: orchestrator → /api/v* tools → /tools/v* rules → /rules/v* issues → /issues/v* public → paths without a versioned prefix (/, /health, /docs, etc.)
- `is_active` boolean, nullable: Filter by active/inactive status.
- `action` string, nullable: Exact-match filter on the action column (e.g. 'repo:view').
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- EndpointPermissionListResponse: Paginated response schema for GET /admin/endpoint-permissions (req 1).
  - `items` EndpointPermissionAdminResponse[], required
    - `id` string, uuid, required
    - `http_method` string, required
    - `path_pattern` string, required
    - `action` string, nullable, required
    - `resource_type` string, nullable, required
    - `resource_extractor` string, nullable, required
    - `description` string, nullable, required
    - `is_active` boolean, required
    - `updated_at` string, date-time, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)