Skip to main content
PUT
Choose what your agent thinks with and its model

Authorizations

Authorization
string
header
required

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

Body

application/json
model
string
required

The model your agent converses on: claude-fable-5-1, claude-opus-5-5, claude-sonnet-5-5 or claude-haiku-5-5.

thinks_with
string
required

What your agent thinks with: aether or claude. claude needs your Claude Code credential stored.

Response

OK

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
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
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
thinks_with
enum<string>
required

What your agent thinks with: aether, Aether inference, paid from your balance and held to the daily cap; claude, your Claude Code credential, your Claude plan's setup token or your Anthropic API key, neither paid from your balance nor held to the cap.

Available options:
aether,
claude
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.