Skip to main content
POST
/
{version}
/
{account_id}
/
{project_id}
/
chat
/
create
Create a new chat conversation
curl --request POST \
  --url https://api.us-1.platform.polyai.app/{version}/{account_id}/{project_id}/chat/create \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-TOKEN: <x-token>'
{
  "conversation_id": "CONV-1234567890",
  "response": "Hi, how can I help?"
}

Authorizations

​
X-API-KEY
string
header
required

You must request an API Key to use PolyAI APIs.

Headers

​
X-API-KEY
string
required

Your PolyAI API key.

​
X-TOKEN
string
required

Agent authentication token (connector).

Path Parameters

​
version
string
required

API version

​
account_id
string
required

Account ID

​
project_id
string
required

Project ID

Response

OK

​
conversation_id
string
required

Unique ID for the created conversation

Example:

"CONV-1234567890"

​
response
string
required

Initial response message from the agent

Example:

"Hi, how can I help?"