Create a session
POST/api/v1/sessions
Creates a new session for the specified agent, along with the underlying conversation, so the caller only needs this single call to start interacting with the agent. No actor is created: pass actor_id to attach an existing actor as the session's end user. When it is omitted the session has no actor, and generations in it carry no end-user attribution — they are not billed to an actor in the usage meter and they match no actor-scoped quota.
Request
Responses
- 201
- 401
- 403
- 404
- 409
Session created
Unauthorized
Forbidden
Not found
An open session already exists for this actor (single_session_per_actor is enabled)