Send a command to a running session
Sends a control message to the run currently bound to the session: `{type: 'stop'}` aborts it, `{type: 'inject', content}` delivers mid-turn steering text. The SDK's `sessions.stop` / `sessions.inject`.
POST
/api/agent/sessions/{sessionId}/commandsPath parameters
sessionIdstringrequiredBody
Request
curl
curl -X POST https://trickest.io/api/agent/sessions/{sessionId}/commands \
-H "Authorization: Bearer $TRICKEST_TOKEN" \
-H "Content-Type: application/json" \
-d '{ }'Responses
200Command outcome
400Bad Request – validation error or malformed input
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
401Unauthorized – missing or expired token
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
403Forbidden – insufficient permissions
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
429Too Many Requests – rate limited
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
500Internal Server Error
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.