> ## Documentation Index
> Fetch the complete documentation index at: https://docs.already.so/llms.txt
> Use this file to discover all available pages before exploring further.

# List sessions

> List sessions with filters, scoped to the authenticated team.

<ParamField path="method" type="GET">`/api/sessions`</ParamField>

**Auth:** Agent key or User JWT + X-Team-Id

## Query parameters

<ParamField query="status" type="string">
  Filter by status (`todo`, `in_progress`, `needs_feedback`, `done`, `cancelled`)
</ParamField>

<ParamField query="assignee_id" type="string">
  Filter by assignee team\_member ID
</ParamField>

<ParamField query="created_by" type="string">
  Filter by creator ID
</ParamField>

<ParamField query="labels[]" type="string">
  Filter by label names
</ParamField>

<ParamField query="q" type="string">
  Search title and description
</ParamField>

<ParamField query="limit" type="number">
  Max results (default 50, max 100)
</ParamField>

<ParamField query="offset" type="number">
  Pagination offset
</ParamField>

## Response

<ResponseField name="sessions" type="Session[]" required>
  Array of session objects
</ResponseField>

<ResponseField name="total" type="number" required>
  Total count matching filters
</ResponseField>