---
title: "List Session Queue"
method: GET
path: "/sessions/{session_id}/queue"
tags: ["Sessions"]
---

# List Session Queue

`GET /sessions/{session_id}/queue`

## Request

- Base URL: `https://api.browser-use.com/api/v4`
- URL: `https://api.browser-use.com/api/v4/sessions/{session_id}/queue`
- Auth: API key in header `X-Browser-Use-API-Key`

List open messages, recently delivered queued messages, and steering cutoffs.

Includes live dispatch claims so clients can restore an accepted queued
message after a refresh without briefly losing its waiting state.

Consumed QUEUE rows are returned too, capped at the most recent
_DELIVERED_QUEUE_HISTORY, plus up to _AGENCY_DELIVERED_QUEUE_HISTORY compact
Agency choice and generation receipts so inbox state survives refresh. A message absorbed mid-run is announced by a
`queued_input_injected` event carrying only its input id, so the chat has no
other source for the text to render. The cap bounds this response because
clients poll it while a run is active; a session with more delivered
follow-ups than the cap renders its oldest injected bubbles without text.

The latest consumed interrupt bridges the primary-write/read-replica gap
before its replacement run appears; clients discard it once that run is
visible. Compact per-source cutoffs preserve every historical interrupted
transcript boundary without returning every historical steering message and
its attachments.

## Path parameters

- `session_id` string, uuid, required

## Response `200`

Successful Response

- QueueListResponse
  - `queue` QueuedMessage[], required
    - `id` integer, required
    - `sessionId` string, uuid, required
    - `runId` string, uuid, nullable, required
    - `mode` 'queue' | 'interrupt', required
    - `status` 'pending' | 'dispatching' | 'consumed' | 'cancelled' | 'superseded' | 'failed', required
    - `text` string, required
    - `attachedFileIds` string[], nullable
    - `createdAt` string, date-time, required
  - `steeringCutoffs` SteeringCutoff[]
    - `sourceRunId` string, uuid, required
    - `createdAt` string, date-time, required

## Other responses

- `403`: Zero Data Retention is enabled on the project (V4 unsupported).
- `404`: Run, session, workspace, or profile not found.
- `422`: Validation Error

---

[API](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4.md) · [All operations](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/llms.txt) · [OpenAPI document](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/revisions/cd7b1eee1102?raw)