Coda APIUsageRuns

Run Usage

Post-hoc credit and token cost for one agent run. run_id is X-Run-Id / job_id from POST /agents. Poll while status is authorized or pricing_pending. thread_id may be null because thread attach is best-effort. Accepts mcp:read or agents:run.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

run_idstringRequired

Headers

x-api-pathstring or nullOptional

Response

Successful Response
job_idstring
run_idstring
sourcestring
statusstring
budgetstring
requested_creditsdouble
Authorization hold reserved when the run started
charged_creditsdouble
Credits actually deducted after settlement or debt
tokensobject

Metered model tokens. Prompt = input; completion = output.

created_atstring
thread_idstring or nullOptional
team_idstring or nullOptional
billed_team_idstring or nullOptional
Team wallet that was debited, when spend used the shared team wallet
billable_creditsdouble or nullOptional
Metered settlement amount, if priced
settled_atstring or nullOptional

Errors

422
Unprocessable Entity Error