brawsrdocsv0.6
API referenceOperations

List project sessions

GET/v1/sessions

Returns a newest-first, cursor-paginated page. Runtime API-key authentication implies the project. Session ID and display_label filters are exact; search is a case-insensitive display-label substring; creation time uses an inclusive lower bound and exclusive upper bound.

AuthorizationBearer <token>

In: header

Query Parameters

limit?integer

Maximum items to return. Defaults to 50.

Range1 <= value <= 100
Default50
cursor?string

Opaque signed cursor returned by the preceding page. It is scoped to the authenticated project, collection, session, filters, and order.

Lengthlength <= 2048
status?string
display_label?string

Exact normalized session display label.

Lengthlength <= 128
search?string

Case-insensitive substring match on the normalized session display label.

Lengthlength <= 128
session_id?string

Exact canonical session ID.

Match^sess_[0-9a-f]{16}([0-9a-f]{16})?$
created_from?string

Inclusive session creation-time lower bound.

Formatdate-time
created_before?string

Exclusive session creation-time upper bound.

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

{  "items": [    {      "id": "string",      "cdp_url": "http://example.com",      "status": "active",      "display_label": "string",      "close_reason": "normal",      "attachable": true,      "created_at": "2019-08-24T14:15:22Z",      "expires_at": "2019-08-24T14:15:22Z",      "closed_at": "2019-08-24T14:15:22Z",      "head_checkpoint_id": "string",      "origin_checkpoint_id": "string",      "parent": {        "session_id": "string",        "checkpoint_id": "string",        "operation_id": "string",        "created_at": "2019-08-24T14:15:22Z"      }    }  ],  "next_cursor": "string"}