Skip to main content
The ingest endpoint receives batches of SDK ledger entries and stores them as Actions under a Run.

Endpoint

Auth

Use:

Payload

reservation_id is optional. Set it to the reservation_id returned by POST /api/v1/budgets/reserve when this entry settles a pre-execution budget hold: ingest replaces the reservation’s estimated amount with this entry’s actual cost_usd, so it stops being double-counted against the budget alongside the real spend.

Behavior

  • Creates the run if it doesn’t exist.
  • Enforces idempotency by skipping duplicate action IDs.
  • Reconciles any reservation_id carried by an entry against its actual cost_usd.
  • Returns 202 Accepted with counts.