Create AI Conversation

Creates a new AI conversation session. The calling account becomes the owner. The endpoint accepts no body parameters; until the user sets a title, the default title (새 대화 or New conversation) is applied based on the request session locale.

Required Permissions

Requires the MEMBER role or higher.

HTTP Request

cURL Example

curl -H "Authorization: Bearer <API_KEY>" \
     -X POST \
     https://HOSTNAME/api/sonar/ai/conversations

Request Parameters

This endpoint accepts no request body parameters.

Success Response

{
  "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "title": "New conversation"
}

• guid (String): GUID of the created conversation
• title (String): Default conversation title (새 대화 if the request session is Korean, otherwise New conversation)

Error Responses

Permission denied

HTTP status code 500

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}