STstacktrace

Upload Usage

Accept one page of one agent's token usage, or its heartbeat (ADR-0077).

A sibling of /detect-runs: usage never travels on the detection document, and neither upload gates the other (stacktrace ADR-0100).

post/api/v1/usage

Request

  • Base URL
    https://api.stacktrace.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.stacktrace.ai/api/v1/usage
  • Auth
    none declared

Headers

authorizationstring nullable

Request body

asset_idstring required
agent_kindstring required
agent_instance_idstring nullable
store_idstring uuid nullable
stacktrace_versionstring required
sent_atstring date-time required
reported_throughstring date-time nullable
covered_fromstring date-time nullable

Response

Successful Response

runs_acceptedinteger required
buckets_acceptedinteger required
figures_acceptedinteger
components_acceptedinteger

Changes

No recorded changes to this operation across all 1 revision of this API.