trickroom / Docs
Sign in
API reference/models

Retrieve retained inference content for inspection or eval preparation; needs traces:read

GET/v1/applications/{id}/inference-traces/{traceId}

Authorization

Authorizationstringrequired

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

Create an application key →

Path parameters

idstringrequired

Min length: 1

traceIdstringrequired

Min length: 1

Query parameters

includestring

tokens adds the call's logprobs and token ids

Allowed: "tokens"

Response

200Retrieve retained inference content for inspection or eval preparation; needs traces:read
X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

idstringrequired
sequencestringrequired
application_idstringrequired
job_idstringrequired
modelstringrequired
protocolstringrequired
statusstringrequired

Allowed: "pending""succeeded""failed"

content_statusstringrequired

Allowed: "retained""opted_out""too_large"

input_tokensstring | nullrequired
output_tokensstring | nullrequired
duration_msstring | nullrequired
created_atstringrequired

Format: date-time · Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

completed_atstring | nullrequired
originstring | nullrequired
turn_idstring | nullrequired
stepinteger | nullrequired
request_groupstring | nullrequired
attemptinteger | nullrequired
sampling_jsonobject | nullrequired
resolved_modelstring | nullrequired
provider_request_idstring | nullrequired
finish_reasonstring | nullrequired
cached_input_tokensstring | nullrequired
reasoning_tokensstring | nullrequired
error_classstring | nullrequired
http_statusinteger | nullrequired
cost_nanostring | nullrequired
tokens_statusstring | nullrequired
tokensobject | null
Allowed shapes

object

logprobsarray<any>required
completion_idsarray<any>required
prompt_idsarray<any> | nullrequired
Allowed shapes

array<any>

itemsany

null

valuenull

null

valuenull
contentobject | nullrequired
Allowed shapes

object

requestobjectrequired

Additional keys: any

responseobject | nullrequired

null

valuenull
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