---
title: "List the approvals queue"
method: GET
path: "/api/assistant/approvals"
tags: ["Mailzero Assistant"]
---

# List the approvals queue

`GET /api/assistant/approvals`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/assistant/approvals`
- Auth: HTTP bearer

The plans waiting for the owner (proposed at draft, or held by a grant) and the questions the assignees asked, across the matters the reader may see. Answer through the work item's interactions: approve or reject a plan, choose an option or instruct on a question. Requires `assistant:read`. A matter made from authentication mail before such mail was kept out of the assistant is shown with its title, summary, ask and plan effects withheld from a reader without `email:auth_secrets`.

## Response `200`

The queue

- AssistantApprovalsView: The approvals queue: the plans waiting for the owner (proposed at draft, or held by a grant) and the questions the assignees asked, across the matters the reader may see
  - `type` 'approvals', required
  - `as_of` string, date-time, required
  - `plans` object[], required
    - `id` string
    - `status` string
    - `requires_approval` boolean
    - `requested_by` string
    - `level` string
    - `rule_id` string, nullable
    - `grant_check` object, nullable
    - `effects` object[]
    - `hash` string
    - `source_revision` integer
    - `expires_at` string, date-time
    - `created_at` string, date-time
    - `work_item` object
      - `id` string
      - `title` string
      - `version` integer
      - `mailbox` object
        - `id` string
        - `address` string
  - `escalations` object[], required
    - `id` string
    - `asked_by` string
    - `question` string
    - `options` object[]
      - `key` string
      - `label` string
      - `outcome` string
    - `plan_id` string, nullable
    - `decision` object, nullable
      - `id` string
      - `version` integer
    - `created_at` string, date-time
    - `work_item` object
      - `id` string
      - `title` string
      - `version` integer
      - `mailbox` object
        - `id` string
        - `address` string

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)