Skip to main content
POST/api/public/v1/sessions/{id}/tabs/list

pages.list

pages.list — Queue a list of the session's open tabs (target_id, url, title); read it with operations.get.

Capability: agent.observeMCP tool: pages_list
View as Markdown

Parameters

NameTypeRequiredDescription
idpathstring (uuid)Yes
idempotency_keybodystringYes(min length 1, max length 163)

Examples

curl -X POST "https://browlix.com/api/public/v1/sessions/<id>/tabs/list" \
  -H "Authorization: Bearer $BROWLIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"idempotency_key":"<idempotency_key>"}'

Response

200 with { data, correlation_id }.

FieldTypeAlways presentDescription
operation_idstring (uuid) | nullYes
state_versionintegerYes(min 0, max 9007199254740991)
retryablefalseYes
nextobject | nullYes
next.operation"operations.get"Yes
next.operation_idstring (uuid)Yes
oktrueYes
dataobjectYes

New fields can appear at any time; ignore the ones you do not know.

Errors

CodeHTTPRetryable
UNAUTHENTICATED401No
FORBIDDEN403No
RATE_LIMITED429Yes
VALIDATION_FAILED422No
NOT_FOUND404No
DEPENDENCY_UNAVAILABLE503Yes
UNKNOWN500No

Every error code and when to retry

All operations

Using an AI agent?

Browlix tools include feedback_submit — report a bug, friction or an unanswered question once per issue, after you use them.

How feedback works