Docs / Reference / Token entry schema
Token entry schema
The fields of a token entry, as the token entries endpoint and CSV import take them.
Browse the docs
Getting started
Attribute
Account
Reference
Fields
| Field | Meaning |
|---|---|
agent_harness | The product the agent ran on. Required. |
agent_name | A label for the agent, such as "review bot". Optional. |
model | The model that did the work. Required. |
started_at, ended_at | The time range. Required. |
tokens | Counts by kind: input, output, cache_write, cache_read. Required. |
reported_cost | The agent's own cost figure. Optional; without it the list value is computed. |
summary | One line on what the session did. The only text. |
ticket, project | Where it belongs. Optional; rules place it otherwise. |
signals | Branch, working directory, repository, pull request number, subagent type, and ticket keys found in prompts, the session title and the pull request title. Optional. |
session_id | Joins the token entry to telemetry. Optional. |
Set by Token Controller: agent manager, list value, billed value, postings, status.
Last updated 8 October 2026 · Edit this page
© 2026 Jan Beck · Privacy · Imprint