Create Session

Create a new conversation session with an AI Agent.

POST/api/v1/workspaces/{workspace_uuid}/agents/{agent_uuid}/sessions

Create a new conversation session with an AI Agent.

Every interaction with an Agent begins by creating a session. The response contains a unique session_uuid which identifies the conversation and must be included in all subsequent chat requests.

Each session maintains its own conversation history and context.

Use the returned session_uuid to send chat messages using the Send Chat Message endpoint.

A single session should be reused for an ongoing conversation. Creating a new session starts a completely new conversation with no previous context.

*Required field

Headers

Header	Type	Description
`Authorization`*	`string`	Bearer token in the format Bearer <your_api_token>

Parameters

Parameter	Type	Description
`workspace_uuid`*	`string`	Unique identifier of the workspace.
`agent_uuid`*	`string`	Unique identifier of the AI Agent.

Request Body

Field	Type	Description
No request body required.

Response Status Codes

200Session created successfully.

401Unauthorized. Invalid or missing API token.

404Workspace or Agent not found.

curl -X POST \
  https://{your_domain}/api/v1/workspaces/{workspace_uuid}/agents/{agent_uuid}/sessions \
  -H "Authorization: Bearer <your_api_token>"

Response 200JSON

{
  "meta": {
  "created_at": "2026-05-20T06:11:48.8777409Z",
  "message": "Session created successfully",
  "session_uuid": "shn-...",
  "status": "SUCCESS"
  },
  "result": {
    "output": {
    "uuid": "shn-...",
    "ws_uuid": "ws-...",
    "user_uuid": "...",
    "created_at": "2026-05-20T06:11:48.8777409Z",
    "agent_uuid": "agn-..."
    }
  }
}