Chart API requests, jobs, time to completion and cost

Counts and duration percentiles per interval, plus exact totals for the window. Requests are calls made with API keys, timed by the API itself (not network or proxies). Time to completion runs from a job's creation to its end, split into queued, starting and running. Buckets align to UTC.

GET/v1/metrics

Authorization

Authorizationstringrequired

Bearer tak_… — an application API key. Keep it on your backend; all resources are scoped to that application.

Create an application key →

Query parameters

application_idstring

Optional with an application key, which always pins the scope. A different application returns 403.

Min length: 1

rangestring

The window back from `to`, instead of `from`. Defaults to 24h.

Allowed: "1h""24h""7d""30d"

fromstring

Start of the window. Defaults to 24 hours before `to`. Windows span at most 31 days, within the 30-day request log.

Format: date-time

tostring

End of the window, not in the future. Defaults to now.

Format: date-time

intervalstring

Bucket size. By default about 60 to 170 points for the window.

Allowed: "1m""5m""15m""1h""1d"

Response

200Chart API requests, jobs, time to completion and cost

X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

application_idstring | nullrequired

fromstringrequired

tostringrequired

intervalstringrequired

Allowed: "1m""5m""15m""1h""1d"

interval_secondsintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

totalsobjectrequired

Object fields

requestsobjectrequired

Object fields

okintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

client_errorintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

server_errorintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

avg_msnumber | nullrequired

p50_msnumber | nullrequired

p95_msnumber | nullrequired

p99_msnumber | nullrequired

Additional keys: any

jobsobjectrequired

Object fields

createdintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

completedintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

failedintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

cancelledintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

avg_secondsnumber | nullrequired

p50_secondsnumber | nullrequired

p95_secondsnumber | nullrequired

p99_secondsnumber | nullrequired

phasesobjectrequired

Object fields

queued_secondsnumber | nullrequired

starting_secondsnumber | nullrequired

running_secondsnumber | nullrequired

queued_p95_secondsnumber | nullrequired

Additional keys: any

failuresobjectrequired

Object fields

timeoutintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

billingintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

approvalintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

agentintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

modelintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

toolintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

computerintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

infrastructureintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

unknownintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

Additional keys: any

startupobjectrequired

Object fields

first_output_p50_secondsnumber | nullrequired

first_output_p95_secondsnumber | nullrequired

jobs_with_outputintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

computersobject | nullrequired

Additional keys: any

cost_nanoobjectrequired

Object fields

model_usagenumberrequired

computer_timenumberrequired

kept_computernumberrequired

Additional keys: any

bucketsarray<object>required

Item fields

requestsobjectrequired

Object fields

okintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

client_errorintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

server_errorintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

avg_msnumber | nullrequired

p50_msnumber | nullrequired

p95_msnumber | nullrequired

p99_msnumber | nullrequired

Additional keys: any

jobsobjectrequired

Object fields

createdintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

completedintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

failedintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

cancelledintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

avg_secondsnumber | nullrequired

p50_secondsnumber | nullrequired

p95_secondsnumber | nullrequired

p99_secondsnumber | nullrequired

phasesobjectrequired

Object fields

queued_secondsnumber | nullrequired

starting_secondsnumber | nullrequired

running_secondsnumber | nullrequired

queued_p95_secondsnumber | nullrequired

Additional keys: any

failuresobjectrequired

Object fields

timeoutintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

billingintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

approvalintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

agentintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

modelintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

toolintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

computerintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

infrastructureintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

unknownintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

Additional keys: any

startupobjectrequired

Object fields

first_output_p50_secondsnumber | nullrequired

first_output_p95_secondsnumber | nullrequired

jobs_with_outputintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

computersobject | nullrequired

Additional keys: any

cost_nanoobjectrequired

Object fields

model_usagenumberrequired

computer_timenumberrequired

kept_computernumberrequired

Additional keys: any

tstringrequired

Additional keys: any

4XX400 invalid input; 401 missing/revoked credentials; 403 disallowed operation/application; 404 missing or inaccessible resource; 409 conflicting submission/version/state; 413 body too large; 415 unsupported content type. Inspect error.code, not message text.

X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

errorobjectrequired

Object fields

codestringrequired

messagestringrequired

request_idstringrequired

Additional keys: any

5XX500 unexpected failure or 503 unavailable dependency. A failed response does not prove that a submission was not committed. Retry job/flow admission with the same key and body.

X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

errorobjectrequired

Object fields

codestringrequired

messagestringrequired

request_idstringrequired

Additional keys: any

{ "application_id": null, "from": "example", "to": "example", "interval": "1m", "interval_seconds": 1, "totals": { "requests": { "ok": 1, "client_error": 1, "server_error": 1, "avg_ms": null, "p50_ms": null, "p95_ms": null, "p99_ms": null }, "jobs": { "created": 1, "completed": 1, "failed": 1, "cancelled": 1, "avg_seconds": null, "p50_seconds": null, "p95_seconds": null, "p99_seconds": null, "phases": { "queued_seconds": null, "starting_seconds": null, "running_seconds": null, "queued_p95_seconds": null }, "failures": { "timeout": 1, "billing": 1, "approval": 1, "agent": 1, "model": 1, "tool": 1, "computer": 1, "infrastructure": 1, "unknown": 1 } }, "startup": { "first_output_p50_seconds": null, "first_output_p95_seconds": null, "jobs_with_output": 1, "computers": null }, "cost_nano": { "model_usage": 1, "computer_time": 1, "kept_computer": 1 } }, "buckets": [ { "requests": { "ok": 1, "client_error": 1, "server_error": 1, "avg_ms": null, "p50_ms": null, "p95_ms": null, "p99_ms": null }, "jobs": { "created": 1, "completed": 1, "failed": 1, "cancelled": 1, "avg_seconds": null, "p50_seconds": null, "p95_seconds": null, "p99_seconds": null, "phases": { "queued_seconds": null, "starting_seconds": null, "running_seconds": null, "queued_p95_seconds": null }, "failures": { "timeout": 1, "billing": 1, "approval": 1, "agent": 1, "model": 1, "tool": 1, "computer": 1, "infrastructure": 1, "unknown": 1 } }, "startup": { "first_output_p50_seconds": null, "first_output_p95_seconds": null, "jobs_with_output": 1, "computers": null }, "cost_nano": { "model_usage": 1, "computer_time": 1, "kept_computer": 1 }, "t": "example" } ] }