Create an agent session

Create an agent session

Creates a session to run agent turns in (see POST /agent/runs). Optionally bound to a workflow, project or space; `mode` defaults to `agent`.

POST/api/agent/sessions
Body
vaultIdstringrequired
workflowIdobject
projectIdobject
spaceIdstring
titlestring
metadataobject
modeenumrequired

One of: agent, plan

Request

curl
curl -X POST https://trickest.io/api/agent/sessions \
  -H "Authorization: Bearer $TRICKEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'

Responses

200The new session
sessionobjectrequired

400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.