> ## 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 Events

> Ingest events captured by the Quint daemon. Rate-limited per organization. Used by the endpoint agent to push captured system events.

<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

<ParamField body="events" type="array" required>
  Array of event objects captured by the daemon.

  <Expandable title="event object properties">
    <ParamField body="action_type" type="string" required>
      Type of OS-level action: `PROCESS_EXEC`, `FILE_READ`, `FILE_WRITE`, `FILE_DELETE`, `NETWORK_CONNECT`.
    </ParamField>

    <ParamField body="tool_name" type="string">
      Binary basename of the tool invoked (e.g., `git`, `node`, `curl`).
    </ParamField>

    <ParamField body="arguments" type="array">
      Process arguments or file paths associated with the action.
    </ParamField>

    <ParamField body="session_id" type="string">
      UUID v5 session identifier linking this event to a session.
    </ParamField>

    <ParamField body="agent_id" type="string">
      Identifier of the detected AI agent.
    </ParamField>

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

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.quintai.dev/v1/events/ingest \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer qt_deploy_YOUR_TOKEN" \
    -d '{
      "events": [
        {
          "action_type": "PROCESS_EXEC",
          "tool_name": "git",
          "arguments": ["commit", "-m", "Fix auth bug"],
          "session_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
          "agent_id": "claude-code",
          "timestamp": "2026-04-12T14:32:00Z"
        }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "ingested": 1
  }
  ```
</ResponseExample>