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

# Ingest

> Upload SDK ledger entries to the platform.

The ingest endpoint receives batches of SDK ledger entries and stores them as **Actions** under a **Run**.

## Endpoint

```text theme={null}
POST /api/v1/ingest/
```

## Auth

Use:

```text theme={null}
Authorization: Bearer <jwt-or-api-key>
```

## Payload

```json theme={null}
{
  "run_id": "uuid",
  "entries": [
    {
      "id": "uuid",
      "timestamp": "ISO-8601",
      "action": "search_web",
      "cost_usd": 0.02,
      "duration_ms": 12.3,
      "outcome": "success",
      "tags": ["tool", "search"],
      "payload": {
        "inputs": {"args": [], "kwargs": {"query": "..." }},
        "outputs": {"results": ["..."]}
      }
    }
  ]
}
```

## Behavior

* Creates the run if it doesn’t exist.
* Enforces idempotency by skipping duplicate action IDs.
* Returns `202 Accepted` with counts.