curl -X POST https://chatatp-agent-builder-backend.onrender.com/v1/conversations/ \
-H "Authorization: Bearer $CHATATP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": 7,
"external_user_id": "user_12345",
"user_display_name": "Jane Customer",
"metadata": { "plan": "pro" }
}'
Conversations
Create a conversation
Create or upsert a conversation for an agent + user pair
POST
/
v1
/
conversations
/
curl -X POST https://chatatp-agent-builder-backend.onrender.com/v1/conversations/ \
-H "Authorization: Bearer $CHATATP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": 7,
"external_user_id": "user_12345",
"user_display_name": "Jane Customer",
"metadata": { "plan": "pro" }
}'
If a conversation already exists for the
agent_id + external_user_id pair, the API returns the existing conversation instead of creating a duplicate.
integer
required
Agent to talk to.
string
required
Your unique identifier for the end user.
string
Optional display name shown in Studio.
object
Optional key-value metadata attached to the conversation.
curl -X POST https://chatatp-agent-builder-backend.onrender.com/v1/conversations/ \
-H "Authorization: Bearer $CHATATP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": 7,
"external_user_id": "user_12345",
"user_display_name": "Jane Customer",
"metadata": { "plan": "pro" }
}'
SDK
const conversation = await client.conversations.create({
agent_id: 7,
external_user_id: "user_12345",
user_display_name: "Jane Customer",
metadata: { plan: "pro" },
});
conversation = await client.conversations.create(
7,
"user_12345",
user_display_name="Jane Customer",
metadata={"plan": "pro"},
)