List Session Queue

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.

GET /sessions/{session_id}/queue

List Session Queue

JavaScript

const options = {method: 'GET', headers: {'X-Browser-Use-API-Key': '<api-key>'}};

fetch('https://api.browser-use.com/api/v4/sessions/{session_id}/queue', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "queue": [
    {
      "id": 123,
      "sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "mode": "queue",
      "status": "pending",
      "text": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "attachedFileIds": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ]
    }
  ],
  "steeringCutoffs": [
    {
      "sourceRunId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

X-Browser-Use-API-Key · string · header · required

Path Parameters

session_id · string<uuid> · required

Response

200

application/json

Successful Response

queue · QueuedMessage · object[] · required

Show child attributes

steeringCutoffs · SteeringCutoff · object[]

Show child attributes