Skip to main content
POST
Resume your paused 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.

created_at
string<date-time>
required
cron_model
enum<string>
required

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

Available options:
claude-fable-5-1,
claude-opus-5-5,
claude-sonnet-5-5,
claude-haiku-5-5,
gpt-6.1-sol,
gpt-6-sol,
gpt-6-astra,
gpt-6-luna
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.

model
enum<string>
required

The model your agent converses on.

Available options:
claude-fable-5-1,
claude-opus-5-5,
claude-sonnet-5-5,
claude-haiku-5-5,
gpt-6.1-sol,
gpt-6-sol,
gpt-6-astra,
gpt-6-luna
runs_on
enum<string>
required

What your agent runs on: aether, Aether inference, paid from your balance and held to the daily cap; stored, your connection connection_id names, paid by its plan or key, neither from your balance nor held to the cap.

Available options:
aether,
stored
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 you (a message from the web does not resume it); 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
connection_id
string<uuid>

The connection your agent runs on; present exactly when runs_on is stored.

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.