Version: 2.0

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.

📄️List outstanding client tool calls on alias-routed session

List the client tool calls a session originally created via this alias is currently waiting on the caller to fulfill. Each entry carries the fully materialized arguments to invoke the tool with; secret-derived values are returned unmasked because the caller needs them to execute the tool, so this endpoint is restricted to the same roles permitted to submit input to the session. Empty when the session is not parked on a client tool. See the agent-scoped endpoint for the full contract.