Skip to main content
GET
Get your agent

Authorizations

Authorization
string
header
required

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

Response

OK

balance
object
required
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
daily_cap
object
required
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
thinks_on
enum<string>
required

What your agent thinks on, from the kind of the connection it runs on: aether, Aether inference, paid from your balance and held to the daily cap; claude_plan, your Claude plan through its setup token; claude_api_key, Anthropic's API on your Anthropic API key; openai_api_key, OpenAI's API on your OpenAI API key. None of the last three is paid from your balance or held to the daily cap.

Available options:
aether,
claude_plan,
claude_api_key,
openai_api_key
timezone
string
required

Your IANA timezone, in which the agent's days and months begin.

tool_usage
object[]
required

Your agent's calls this month to each tool provider Aether pays for on its behalf, every provider listed.

usage_this_month
object
required
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.

memory
object
memory_edit
object