Pause an agent run
Interrupts a run at its next safe point without discarding its work.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
id
Headers
idempotency-key
Retries with the same key replay the first applied mutation.
Query parameters
wait
How many seconds to hold the request open. Releases early the moment the run finishes or blocks on a person. Maximum 120; 0 returns immediately.
Response headers
idempotent-replay
true when this response replays an earlier request.
Response
The run state after the pause request.
object
action
run
Errors
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error