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

# Ingest Sessions

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

<Note>
  Requires `Authorization: Bearer` header with a deploy token (`qt_deploy_*`) or Supabase JWT.
</Note>

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

## Request Body

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

<ParamField body="session_id" type="string" required>
  UUID v5 session identifier.
</ParamField>

<ParamField body="session_name" type="string">
  Human-readable session name.
</ParamField>

<ParamField body="model" type="string">
  LLM model used in the session (e.g., `claude-sonnet-4-20250514`).
</ParamField>

<ParamField body="signing_id" type="string">
  Code signing identity of the agent process.
</ParamField>

<ParamField body="state" type="string" required>
  Session state: `active`, `idle`, `ended`.
</ParamField>

<ParamField body="platform" type="string">
  Agent platform identifier (e.g., `claude-code`, `cursor`, `windsurf`).
</ParamField>

<ParamField body="parent_id" type="string">
  Parent session UUID for hierarchical session tracking.
</ParamField>

<ParamField body="timestamp" type="datetime" required>
  ISO 8601 timestamp of the lifecycle event.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  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"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "ok": true
  }
  ```
</ResponseExample>