Skip to main content
POST
Pause your agent

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Accepted

browser_tools
boolean
required

Whether your agent may drive a browser. Off by default; a change applies when Hermes next starts, which a running agent does at once.

conversation_model
string
required

The model your agent converses on.

created_at
string<date-time>
required
cron_model
string
required

The model your agent's scheduled jobs run on, unless a job names another.

id
string<uuid>
required
last_used_at
string<date-time>
required

When your agent was created or resumed, was sent a message, or last worked. Thirty days unused pauses it.

state
enum<string>
required

The host's lifecycle state. running: Hermes takes messages now; suspending and idle: asleep, woken by the next message; waking, resuming: coming up for a message; provisioning and booting: being created; updating: moving onto a new image; pausing and paused: backed up after thirty days unused, or paused by you, and resumed by the next message or by you; lost: its machine is gone and only deleting it helps; destroying: being deleted.

Available options:
provisioning,
booting,
running,
suspending,
idle,
waking,
updating,
pausing,
paused,
resuming,
lost,
destroying,
destroyed
default_project_id
string<uuid>

The project a task your agent starts runs on when it names no repository. Without it such a task is refused.