# List sessions

Launch stage: Beta

`GET /api/2.0/agents/{parent=session-stores/*}/sessions`

Lists sessions within a session store.

API scopes: agent-kit

## Path parameters

- `parent` (string, required)
  Resource name of the containing session store, in the form
   `session-stores/{session_store_id}`.

## Query parameters

- `page_size` (int32, optional)
  Maximum number of sessions to return. Defaults to 10; must be between 1 and 100.
- `page_token` (string, optional)
  Token returned by a previous list request.
- `filter` (string, optional)
  Filter expression. Supported fields include `actor_id` and `metadata`; for example,
   `actor_id = "support-customer-123"`.
- `order_by` (string, optional)
  Sort order. Defaults to `last_activity_time desc`. Page-token continuation is exactly-once when
   ordering by `create_time` (immutable); ordering by `last_activity_time` is best-effort, because
   that value changes as a session gains activity, so a session updated between page requests may
   be repeated or skipped. To enumerate every session exactly once, order by `create_time`.

## Returns

Returns a list of Session objects.

## Response

```json
{
  "sessions": [
    {
      "session_id": "string",
      "actor_id": "string",
      "parent_session_id": "string",
      "root_session_id": "string",
      "metadata": {},
      "create_time": "string",
      "update_time": "string",
      "last_activity_time": "string",
      "name": "string"
    }
  ],
  "next_page_token": "string"
}
```