Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKSandbox SDKAPI ReferenceChangelog
Get an agent session

Get an agent session

Returns the session row plus its live projection: todos, pending plan approval, active plans, subagent runs and the active/live run.

GET/api/agent/sessions/{sessionId}
Path parameters
sessionIdstringrequired

Request

curl
curl -X GET https://trickest.io/api/agent/sessions/{sessionId} \
  -H "Authorization: Bearer $TRICKEST_TOKEN"

Responses

200Session with projection
sessionobjectrequired

todosobject[]required
pendingPlanApprovalobjectrequired
activePlansobject[]required
subagentRunsobject[]required
activeRunobjectrequired
liveRunobjectrequired
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.

PreviousAgent - SessionsCreate an agent sessionAgent - SessionsNextUpdate an agent session