DEdexto
Agents

Create a session

Start a session for one of your end users, pinned to the agent's current version unless you name one.

post/v1/agents/{agent_id}/sessions

Request

  • Base URL
    https://api.dexto.ai
  • URL
    https://api.dexto.ai/v1/agents/{agent_id}/sessions
  • Auth
    HTTP bearer

Path parameters

agent_idstring required

Request body

metadataobject

Your context for this session, such as a tenant id. Function tools receive it with every call; the model never sets it.

userstring required

Your identifier for the end user. Dexto stores it as a label.

versioninteger

Pin an existing version instead of the current one.

Response

Created.

agent_idstring uuid required
created_atstring date-time required
expires_atstring date-time nullable required

When the session is deleted under its Cloud project's session retention, counted from its last message or run; null when it is kept until you delete it.

idstring uuid required
metadataobject required
object'agent_session' required
userstring required
versioninteger required

Changes

No recorded changes to this operation across all 1 revision of this API.