List Sessions

Get paginated list of AI agent sessions with optional status filtering.

Query parameters

pageSizeintegerOptional>=1<=100Defaults to 10

pageNumberintegerOptional>=1Defaults to 1

filterByenum or nullOptional

Enumeration of possible (browser) session states

Attributes: ACTIVE: Session is currently active and running (browser is running) STOPPED: Session has been stopped and is no longer active (browser is stopped)

Allowed values:

Response

Successful Response

itemslist of objects

List of session views for the current page

totalItemsinteger

Total number of items in the list

pageNumberinteger

Page number

pageSizeinteger

Number of items per page

1	{
2	"items": [
3	{
4	"id": "string",
5	"status": "active",
6	"startedAt": "2024-01-15T09:30:00Z",
7	"liveUrl": "string",
8	"finishedAt": "2024-01-15T09:30:00Z"
9	}
10	],
11	"totalItems": 1,
12	"pageNumber": 1,
13	"pageSize": 1
14	}

Headers

Query parameters

Response

Errors