Skip to main content
POST
/
org
/
{org_id}
/
agent-sessions
/
{session_id}
/
start
Start agent session
curl --request POST \
  --url https://v2-nova-api.prod.czmx.in/api/org/{org_id}/agent-sessions/{session_id}/start \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agentId": "<string>",
  "instruction": "<string>",
  "title": "<string>",
  "source": "<string>",
  "prospectId": "<string>"
}
'
{
  "sessionId": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
org_id
string
required

Organization ID

​
session_id
string<uuid>
required

Client-generated UUID v4 for the session

Body

application/json

Session start parameters

​
agentId
string
required

ID of the agent to run for this session.

​
instruction
string
required

Initial instruction sent to the agent as the first user message.

​
title
string

Human-readable label for the session.

​
source
string

Caller identifier (e.g. command-center, api).

​
prospectId
string

ID of an existing prospect to associate with the session.

Response

Session started

​
sessionId
string

The UUID of the newly started session.