Skip to main content
POST
/
api
/
assistants
/
threads
Start a new session thread
curl --request POST \
  --url https://agent-service-511985928315.us-east4.run.app/api/assistants/threads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Envole-User-Id: <api-key>' \
  --data '{
  "agentId": "agent_123"
}'
{
  "id": "thread_456",
  "threadName": "Project Ideas",
  "agentId": "agent_123",
  "agentName": "Demo Agent",
  "agentHandle": "demo-agent",
  "rootAgentBuildId": "build_123",
  "lastMessageTime": "2024-01-01T12:00:00Z",
  "sessionType": "LIVE"
}
Create a new session thread for an agent.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
X-Envole-User-Id
string
header
required

External user identifier; not necessarily registered with Envole

Body

application/json
​
agentId
string
required

Response

Session thread created successfully.

​
id
string
​
threadName
string
​
agentId
string
​
agentName
string
​
agentHandle
string
​
rootAgentBuildId
string
​
lastMessageTime
string<date-time>
​
sessionType
enum<string>
Available options:
LIVE,
TESTING
⌘I