Pause every agent
POST
/pause
const url = 'http://127.0.0.1:7700/api/pause';const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url http://127.0.0.1:7700/api/pause \ --header 'Authorization: Bearer <token>'The owner or, on Business, an admin. Each running task is frozen, no new task starts (it stays
queued), and a reboot keeps it paused. Approvals can still be answered. Pausing is a kill-switch
note that says who and from which phone or screen.
Authorizations
Section titled “Authorizations”Responses
Section titled “Responses”The state.
Media typeapplication/json
object
paused
required
boolean
by
required
Who pulled the switch. GurtOS when the box paused itself.
string | null
at
required
string | null format: date-time
via
required
The phone or screen it came from, or an unreadable permissions file when the box paused itself. Check Settings, Permissions, then resume.
string | null
Example generated
{ "paused": true, "by": "example", "at": "2026-04-15T12:00:00Z", "via": "example"}The owner’s route, called by someone who is not the box’s own screen or a device paired as the owner.
Media typeapplication/json
object
error
required
What went wrong
string
Example
{ "error": "only this computer's own screen or the owner's paired device can do this"}