# Create a session

> 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.

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create a session"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/api/v1/sessions"}
  context={"endpoint"}
>
  
</MethodEndpoint>

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.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails>
  
</ParamsDetails>

<RequestSchema
  {...require("./create-session.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./create-session.StatusCodes.json")}
>
  
</StatusCodes>