trickroom / Docs
Sign in
API reference/assistants

Log a choice made at a decision point, with the logging policy's probability of it

Application-scoped assistant control plane. External pipelines, dataset ingestion, and training run in the builder's infrastructure. Eval suites run fixture tool-mode jobs or disposable offline Linux desktops through Temporal. Metrics/artifacts are externally reported; reference URLs are never fetched. Model credentials are write-only. Pull subscriptions replay unacknowledged events. Resource lists return up to 200 recent records; trigger lists return an ID next_cursor for after, and message and delivery feeds use sequence cursors.

POST/v1/applications/{id}/decisions

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

Body

pointstringrequired

Pattern: ^[a-zA-Z0-9_.-]{1,100}$

policystringrequired

Pattern: ^[a-zA-Z0-9_.-]{1,100}$

optionsarray<string>required

Min items: 1 · Max items: 100

chosenstringrequired

Min length: 1 · Max length: 200

probabilitiesobjectrequired

Additional keys: number

job_idstring

Min length: 1 · Max length: 200

keystring

Min length: 1 · Max length: 200

rewardnumber

Minimum: -1000000000 · Maximum: 1000000000

detailobject

Additional keys: any

Response

201Log a choice made at a decision point, with the logging policy's probability of it
X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

idstringrequired
job_idstring | nullrequired
keystring | nullrequired
pointstringrequired
policystringrequired
optionsarray<string>required
chosenstringrequired
probabilitiesobjectrequired

Additional keys: number

propensitynumberrequired
rewardnumber | nullrequired
rewarded_atstring | nullrequired
detailobjectrequired

Additional keys: any

created_atstringrequired
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