v1

latestOpenAPI 3.1.02026-07-26751285.0 KB
messaging

Create a new session

Creates a new chat session for a user with a specific agent. Sessions provide a simplified way to interact with agents without the complexity of managing servers, channels, or participants.

Key Benefits:

  • No channel management required - just provide agent and user IDs
  • Automatic infrastructure handling - no need to create servers or channels
  • Persistent conversation state maintained across messages
  • Ideal for building chat interfaces, personal assistants, and direct user-to-agent interactions

Sessions maintain conversation state and context across multiple messages, providing a persistent chat experience similar to modern AI assistants.

post/api/messaging/sessions

Request body

agentIdstring uuid required

ID of the agent to start a session with

userIdstring uuid required

ID of the user creating the session

Response

Session created successfully

sessionIdstring

Unique identifier for the created session

agentIdstring uuid
userIdstring uuid
createdAtstring date-time
metadataobject
expiresAtstring date-time

When the session will expire