Install
Enable sync (recommended)
Parameters
Authentication
The SDK sends:- JWT tokens (user sessions)
- API keys (recommended for agents). Use a per-agent key so the platform can bind every entry to one agent.
Authorization: Bearer. The older
ApiKey <key> scheme is no longer sent.
Identity headers
Alongside the key, the SDK sends the identity of the caller as headers so the platform can attribute actions without trusting values in the request body:
Headers whose value is unset are omitted. Set
harness and principal on
configure():
actor on each ledger row.
Operational behavior
- Uploads are retried with exponential backoff (network/server errors).
- Auth failures (401) are not retried.
- If the platform is down, entries remain local and your agent continues.
- If the batch references an agent, run or mission with an active
kill switch, the platform rejects it with
423 Lockedand records aHARD_BLOCKintervention.