Create end user session for alias
POST/v2/agent_aliases/:alias_key/end_user_sessions
Creates a session owned by the calling end user, routed through this alias's policy. The session's owning principal is the caller's authenticated identity.
Ownership binds to the alias key, not the resolved agent, so it is unaffected by a later change to the alias's routing weights.
Returns 429 when the caller reaches the live-session or hourly session-creation cap.
Request
Responses
- 201
- 403
- 404
- 409
- 422
- 429
The newly created session.
Permissions do not allow creating sessions for this alias.
Alias not found.
No session was created. Either the requested session key or name is already taken, or the resolved agent's run_condition evaluated to false. A collision names itself in messages and needs a different key or name. A run_condition refusal carries a generic message on this surface, and the same request succeeds once the expression, or the metadata it reads, changes.
No session was created. A session_enrichment tool call on the resolved agent has an invalid configuration or its transform raised an error, or the resolved agent's run_condition returned a non-boolean. messages carries a generic failure message on this surface and does not identify the cause. createAgentSession (POST /v2/agents/{agent_key}/sessions) reports the specific cause.
The request exceeds the caller's live-session or hourly session-creation cap.