Pause agent run
Pause a queued or running run gracefully: it stops at its next step boundary (after the current step’s tool calls return, before the next model request), never mid tool call, with pause reason user_requested. Resume continues the same run. A paused run stays paused (pauseRequested false); a finished run returns 409.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.
Managed agent id (UUID), as returned by the list/create agents endpoints.
Agent run id (UUID), as returned by the start/list runs endpoints.
Response
PauseAgentRunResponse
a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$The run status when the request was recorded; a running run pauses at its next step boundary.
queued, running, paused, succeeded, failed, cancelled True when a pause was newly requested; false when the run was already paused.