List Sessions

List sessions with filtering by state, platform, root_only, and since.

GET /v1/sessions

cURL

curl "https://api.quintai.dev/v1/sessions?state=active&root_only=true" \
  -H "Authorization: Bearer qt_deploy_YOUR_TOKEN"

200

{
  "sessions": [
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "session_name": "Fix auth middleware",
      "model": "claude-sonnet-4-20250514",
      "signing_id": "com.anthropic.claude-code",
      "state": "active",
      "platform": "claude-code",
      "parent_id": null,
      "started_at": "2026-04-12T14:00:00Z",
      "ended_at": null
    }
  ]
}

Requires Authorization: Bearer header with a deploy token (qt_deploy_*) or Supabase JWT.

Query Parameters

state · string

Filter by session state: active, idle, ended.

platform · string

Filter by agent platform (e.g., claude-code, cursor).

root_only · boolean

When true, return only root sessions (no parent). Useful for top-level overview.

since · datetime

RFC 3339 timestamp (2026-04-11T09:30:00Z) or a bare date (2026-04-11, interpreted as midnight UTC). Only return sessions started on or after this time. Relative words like yesterday are rejected.

Response

sessions · array

Array of session records matching the filters.

Show session object properties

id · string

Session UUID.

session_name · string

Human-readable session name.

model · string

LLM model used.

signing_id · string

Code signing identity of the agent process.

state · string

Current state: active, idle, ended.

platform · string

Agent platform identifier.

parent_id · string

Parent session UUID, or null for root sessions.

started_at · datetime

When the session began.

ended_at · datetime

When the session ended. null if still active.

cURL

curl "https://api.quintai.dev/v1/sessions?state=active&root_only=true" \
  -H "Authorization: Bearer qt_deploy_YOUR_TOKEN"

200

{
  "sessions": [
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "session_name": "Fix auth middleware",
      "model": "claude-sonnet-4-20250514",
      "signing_id": "com.anthropic.claude-code",
      "state": "active",
      "platform": "claude-code",
      "parent_id": null,
      "started_at": "2026-04-12T14:00:00Z",
      "ended_at": null
    }
  ]
}