Skip to main content
POST
/
api
/
conversation
/
new
{
  "boardId": "abc123",
  "chatId": "chat-node-456",
  "name": "My Custom Conversation"
}

{
  "conversationId": "6de563f8-9b05-4710-9b46-4dd6761e2942",
  "name": "My Custom Conversation",
  "createdAt": "2025-04-23T09:09:59.619Z",
  "boardId": "abc123",
  "chatId": "chat-node-456"
}
This endpoint creates a new conversation (thread) for a ChatNode. The returned conversation ID can be used with /api/conversation/{conversationId} to send messages.

​
Headers

​
x-api-key
string
required
Your API key for authentication. Can also be passed as api_key query parameter.

​
Request Body

​
boardId
string
required
The ID of the board where the ChatNode exists. Can also be passed as board_id query parameter.
​
chatId
string
required
The ChatNode ID. Can also be passed as chat_id query parameter.
​
name
string
Optional custom name for the conversation. If not provided, defaults to “API Conversation - ”.

​
Response

​
conversationId
string
Unique identifier for the newly created conversation
​
name
string
The conversation name
​
createdAt
string
ISO timestamp when the conversation was created
​
boardId
string
The board ID where the ChatNode exists
​
chatId
string
The ChatNode ID associated with this conversation
{
  "boardId": "abc123",
  "chatId": "chat-node-456",
  "name": "My Custom Conversation"
}

{
  "conversationId": "6de563f8-9b05-4710-9b46-4dd6761e2942",
  "name": "My Custom Conversation",
  "createdAt": "2025-04-23T09:09:59.619Z",
  "boardId": "abc123",
  "chatId": "chat-node-456"
}

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key."
}

{
  "error": "Validation failed",
  "message": "Request validation failed. Please check your parameters.",
  "details": {}
}
Creating a conversation does not send a message. To send a message, use POST /api/conversation/ {conversationId} after you create the conversation.