Skip to main content
POST
Record hosted-agent usage

Authorizations

Authorization
string
header
required

Galinum's scoped hosted-agent key (pk_agent_...). It can read required project state, including launch policy and campaign activation, and use fenced evaluation or GitHub source operations. Ordinary campaign, status, goal, segment, media, launch-policy, and campaign-activation writes return 403. Reads grant no approval or deployment configuration authority.

Body

application/json

Send Content-Type: application/json with a Content-Length from 1 through 8,192 bytes. Larger requests return 413.

executionId
string
required
Required string length: 1 - 128
calls
object[]
required

Per-call usage objects. The server accepts at most 200 entries, but the 8,192-byte request limit is authoritative and may allow fewer depending on the included fields.

Minimum array length: 1
sessionId
any

Optional session metadata. Stored only when this value is a string; other JSON values are treated as omitted.

model
any

Optional model metadata. Stored only when this value is a string; other JSON values are treated as omitted.

Response

The stored usage result. replayed is true when executionId already existed.

executionId
string
required
credits
integer
required
Required range: x >= 0
costMicros
integer
required
Required range: x >= 0
replayed
boolean
required