List Session Queue

List open messages, the latest handoff row, and all steering cutoffs.

Includes live dispatch claims so clients can restore an accepted steering handoff after a refresh without briefly losing its waiting state. 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