trickroom / Docs
Sign in
API reference/observability

List API requests made with keys, newest first

Each call made with an application or workspace key: route, status, duration, error code, and the job it created or read, with that job's status and cost. Kept for 30 days.

GET/v1/logs

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

statusstring

A status class like 4xx or an exact code like 404.

Pattern: ^([1-5]xx|[1-5][0-9]{2})$

methodstring

HTTP method.

Allowed: "GET""POST""PUT""PATCH""DELETE"

searchstring

A path fragment, or an exact request ID, job ID or error code.

Min length: 1 · Max length: 200

beforestring

Request ID to page from: use `next` from the previous page.

limitinteger

Maximum rows in this page.

Default: 50 · Minimum: 1 · Maximum: 100

Response

200List API requests made with keys, newest first
X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

dataarray<object>required
Item fields
idstringrequired
created_atstringrequired
methodstringrequired
routestringrequired
pathstringrequired
statusintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

duration_msintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

error_codestring | nullrequired
application_idstring | nullrequired
application_namestring | nullrequired
key_idstring | nullrequired
key_namestring | nullrequired
job_idstring | nullrequired
jobobject | nullrequired
Allowed shapes

object

statusstringrequired
created_atstringrequired
completed_atstring | nullrequired
cost_nanonumberrequired

null

valuenull

Additional keys: any

nextstring | nullrequired
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