---
title: "Return hosted controlled-action queue for Approval UI"
method: GET
path: "/tenant/action-queue"
---

# Return hosted controlled-action queue for Approval UI

`GET /tenant/action-queue`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/tenant/action-queue`
- Auth: HTTP bearer

Lists tenant action queue items joined with redacted ledger metadata so approvers can inspect pending, leased, failed or completed hosted worker handoffs.

## Query parameters

- `state` string
- `limit` integer

## Response `200`

Tenant action queue

- object
  - `status` 'hosted_action_queue_status_ready', required
  - `source` string, required
  - `tenant_id` string, required
  - `filters` object, required
    - `state` string[]
    - `limit` integer
  - `queue_item_count` integer, required
  - `queue_items` object[], required
  - `state_counts` object, required
  - `hosted_auth_context` object
  - `raw_secrets_returned` false, required

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)