trickroom / Docs
Sign in
API reference/evidence

Get verification results, diagnosis and evidence

GET/v1/jobs/{id}/report

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

Response

200Get verification results, diagnosis and evidence
X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

job_idstringrequired

Min length: 1

user_idstringrequired

Min length: 1

application_idstringrequired

Min length: 1

statusstringrequired

Allowed: "queued""provisioning""running""waiting_approval""completed""failed""cancelled""timed_out"

evaluationobjectrequired

Additional keys: any

usageobjectrequired

Additional keys: any

diagnosisobject | nullrequired

Read-only diagnosis generated from saved job evidence. Null for active jobs and completed jobs without failed or inconclusive verification. Does not execute actions or call a model.

Allowed shapes

object

version"trickroom-diagnosis-v1"required
categorystringrequired

Allowed: "cancelled""timeout""billing""approval""agent""model""tool""computer""infrastructure""unknown""verification"

summarystringrequired
causeobjectrequired
Object fields
statusstringrequired

Allowed: "known""undetermined"

detailstringrequired
ownerstringrequired

Allowed: "builder""user""workspace_admin""model_provider""integration_owner""operator"

locationobjectrequired
Object fields
phasestringrequired

Allowed: "execution""verification""model""tool""computer"

event_idstring | null
event_sequenceinteger | null
turn_idstring | null
action_idstring | null
evidencearray<object>required
Item fields
sourcestringrequired

Allowed: "job""event""check"

detailstringrequired
event_idstring | null
event_sequenceinteger | null
event_typestring | null
check_idstring | null
artifact_idstring | null
next_stepsarray<string>required
recoveryobjectrequired
Object fields
statusstringrequired

Allowed: "review_before_retry""fix_before_retry""reconcile_first"

detailstringrequired
limitationsarray<string>required

null

valuenull
state_snapshotobject | nullrequired

Initial and final simulated service state captured after a stateful evaluation, including partial effects of failed execution. Null without a collected state snapshot.

Allowed shapes

object

artifact_idstringrequired

Min length: 1

execution_statusstringrequired

Allowed: "queued""provisioning""running""waiting_approval""completed""failed""cancelled""timed_out"

content_urlstringrequired

null

valuenull
evidenceobjectrequired
Object fields
artifactsarray<object>required
Item fields
idstringrequired

Min length: 1

job_idstringrequired

Min length: 1

kindstringrequired

Allowed: "screenshot""file"

namestringrequired
mime_typestringrequired
sha256stringrequired
byte_sizeintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

metadata_jsonobjectrequired

Additional keys: any

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)))$

event_sequenceinteger | nullrequired
content_urlstringrequired

Additional keys: any

screenshots_enabledbooleanrequired
capture_issuesarray<object>required

Additional keys: any

human_interventionsintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

events_urlstringrequired

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