agents

Send an agent a turn.

Changed on

Starts a new turn with the given input. Requires the machine:exec scope.

post/v1/agents/{name}/turns

Request

Path parameters

namestring required

Session name

Headers

Idempotency-Keystring nullable

Retry the same turn without running it twice; a different request using the same key conflicts

Request body

envobject

Environment for this turn only — typically the model API key. Never stored.

promptstring required
timeoutSecondsinteger nullable

Longest the turn may run (default 1800 s).

Response

Turn started; it runs whether or not a client stays connected

turninteger required

Changes