Agent Aliases

Manage routing aliases that map a public name to one or more agents under a configurable policy. Create a session through an alias (POST /v2/agent_aliases/{alias_key}/sessions) and the alias's policy picks the underlying agent that runs.

📄️ Create an alias

Create a new alias. Aliases are routing primitives that map a public name to one or more underlying agents under a configurable policy. When a session is created through an alias (via `POST /v2/agent_aliases/{alias_key}/sessions`), the alias's policy decides which underlying agent runs that session.

📄️ List aliases

List all aliases owned by the current customer.

📄️ Get an alias

Retrieve a specific alias including its policy.

📄️ Update an alias's metadata

Update an alias's metadata fields (name, description, enabled, metadata). To replace the routing policy, use `PUT /v2/agent_aliases/{alias_key}/policy` — policies are atomic and not partially updatable.

📄️ Delete an alias

Delete an alias. The underlying agents the alias points at are not affected. Returns 409 if any live resources still reference this alias.

📄️ Replace an alias's routing policy

Atomically replace the alias's routing policy and stickiness configuration. Replacement is whole-object; partial merging is not supported.

📄️ Create session via alias

Create a new session by routing through an alias. The alias's policy is evaluated to pick the underlying agent that will own the session. Subsequent operations on the session can be addressed via this alias or directly via `/v2/agents/{resolved_agent_key}/sessions/{session_key}`.

📄️ List sessions routed via this alias

List sessions that were originally created via this alias (sessions whose `alias_key` matches). Sessions are also reachable under their resolved agent's URL; this endpoint is the alias-scoped view.

📄️ Get alias-routed session

Retrieve a session originally created via this alias.

📄️ Update alias-routed session

Update a session originally created via this alias.

📄️ Delete alias-routed session

Delete a session originally created via this alias.

📄️ Submit input to alias-routed session

Submit an input event to a session originally created via this alias. The session's resolved agent runs the loop.

📄️ List events on alias-routed session

List events of a session originally created via this alias.

📄️ Get event on alias-routed session

Get a single event of a session originally created via this alias.

📄️ Delete event on alias-routed session

Delete a single event of a session originally created via this alias.

📄️ Hide event on alias-routed session

Manually hide an event on a session originally created via this alias. Sets hide_reason to 'manual'.

📄️ Unhide event on alias-routed session

Unhide a hidden event on a session originally created via this alias. Clears the hide_reason.

📄️ List artifacts on alias-routed session

List artifacts stored in a session originally created via this alias. Artifacts are files either uploaded by the user, or generated within the session.

📄️ Get artifact on alias-routed session

Retrieve an artifact stored in a session originally created via this alias, including metadata and base64-encoded file content.