---
title: "Inspect the hosted approval inbox across principals"
method: GET
path: "/v1/admin/approvals"
tags: ["governance", "admin"]
---

# Inspect the hosted approval inbox across principals

`GET /v1/admin/approvals`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/admin/approvals`
- Auth: HTTP bearer

## Query parameters

- `principal_id` string
- `skill` string
- `route` string
- `limit` string
- `cursor` string

## Response `200`

Approval inbox.

- ApprovalInboxEnvelope
  - `status` 'success', required
  - `approvals` ApprovalInboxItem[], required
    - `run_id` string, required
    - `principal_id` string, required
    - `skill` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `policy_binding` object
      - `bundle_id` string, required
      - `bundle_version` string, required
      - `scope_kind` 'workspace_default' | 'skill', required
      - `scope_ref` string
    - `request_id` string, required
    - `request_digest` string, required
    - `gate` HostedApprovalGate, required
      - `id` string, required
      - `type` string
      - `reason` string, required
      - `summary` object
    - `route` ApprovalRouteSnapshot
      - `route_id` string, required
      - `missing` boolean
      - `title` string
      - `summary` string
      - `recipients` PolicyApprovalRouteRecipient[], required
        - `kind` 'principal' | 'email' | 'slack_channel' | 'webhook', required
        - `value` string, required
        - `label` string
    - `matched_by` object, required
      - `kind` 'none' | 'default' | 'rule', required
      - `rule_id` string
      - `skill` string
      - `gate_type` string
      - `gate_id` string
  - `next_cursor` string

## Other responses

- `400`: Invalid page limit or approval cursor.
- `401`: Unauthorized.
- `403`: Forbidden.

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)