Skip to main content
GET
/
v1
/
agents
/
runs
/
{runId}
/
messages
List Run Messages
curl --request GET \
  --url https://api.browserbase.com/v1/agents/runs/{runId}/messages \
  --header 'X-BB-API-Key: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "message": {
        "content": "<string>"
      }
    }
  ],
  "nextSince": "<string>"
}

Authorizations

​
X-BB-API-Key
string
header
required

Your Browserbase API Key.

Path Parameters

​
runId
string<uuid>
required

The run ID.

Query Parameters

​
since
string

The id of the last message you've already received. The response will contain messages produced after that one, in chronological order. Omit on the first call. Pass the previous response's nextSince value to continue paging or to poll for new messages.

​
limit
integer
default:20

Maximum number of messages to return.

Required range: 1 <= x <= 100
​
all
boolean
default:false

Return every message after since in one response, ignoring limit.

Response

200 - application/json

The page of messages, in chronological order, with the oldest messages first.

​
data
object[]
required

The page of messages, in chronological order, with the oldest messages first.

​
nextSince
string | null
required

The id of the last message in data. Pass it back as since on the next request to continue paging, or to poll for new messages. null only when the run has no messages yet; in that case, omit since and retry.