Ingest Sessions

Ingest session lifecycle events from the Quint daemon. Rate-limited per organization.

POST /v1/sessions/ingest

cURL

curl -X POST https://api.quintai.dev/v1/sessions/ingest \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer qt_deploy_YOUR_TOKEN" \
  -d '{
    "session_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,
    "timestamp": "2026-04-12T14:00:00Z"
  }'

200

{
  "ok": true
}

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

This endpoint is rate-limited per organization. It is designed for daemon-to-cloud ingestion, not direct API usage.

Request Body

Session lifecycle events report session start, update, and end transitions.

session_id · string · required

UUID v5 session identifier.

session_name · string

Human-readable session name.

model · string

LLM model used in the session (e.g., claude-sonnet-4-20250514).

signing_id · string

Code signing identity of the agent process.

state · string · required

Session state: active, idle, ended.

platform · string

Agent platform identifier (e.g., claude-code, cursor, windsurf).

parent_id · string

Parent session UUID for hierarchical session tracking.

timestamp · datetime · required

ISO 8601 timestamp of the lifecycle event.

cURL

curl -X POST https://api.quintai.dev/v1/sessions/ingest \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer qt_deploy_YOUR_TOKEN" \
  -d '{
    "session_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,
    "timestamp": "2026-04-12T14:00:00Z"
  }'

200

{
  "ok": true
}