List browser sessions

GET

/api/v1/browser-sessions

• Production
• Local development

Returns a paginated, filterable list of browser sessions for the authenticated tenant.

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

page

Page number (1-indexed)

integer

default: 1 >= 1

Page number (1-indexed)

limit

Items per page (max 100)

integer

default: 20 >= 1 <= 100

Items per page (max 100)

agent_role

Any of:

string

string

null

null

Filter by agent role (e.g. ‘cro’)

tier

Any of:

string

string

null

null

Filter by tier (research, account, payment)

status

Any of:

string

string

null

null

Filter by status (pending, running, completed, failed, timeout)

Responses

200

Successful Response

Response for GET /api/v1/browser-sessions.

Attributes: data: List of session summaries. meta: Pagination metadata.

object

data

required

Array<object>

Summary of a single browser session for list views.

Attributes: id: Session UUID. agent_role: Which agent ran the session. tier: Autonomy tier. task: Browsing objective description. target_url: Starting URL. status: Current lifecycle status. credits_consumed: Credits used. duration_ms: Session duration in milliseconds. created_at: When the session was requested.

object

agent_role

required

string

created_at

Any of:

string

string

null

null

credits_consumed

integer

duration_ms

Any of:

integer

integer

null

null

id

required

string

status

required

string

target_url

required

string

task

required

string

tier

required

string

meta

required

Pagination metadata for session list responses.

Attributes: total: Total matching sessions. page: Current page number. limit: Items per page.

object

limit

required

integer

page

required

integer

total

required

integer

422

Validation Error

object

detail

Array<object>

object

ctx

object

input

loc

required

Array

msg

required

string

type

required

string