curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation CreateConversation($domainId: String!, $hidden: Boolean!) { id: createConversation(domainId: $domainId, hidden: $hidden) }",
    "variables": {
      "domainId": "domain_123456789",
      "hidden": false
    }
  }' \
  https://{ACCOUNT}.askwisdom.ai/graphql
{
  "data": {
    "id": "conv_987654321"
  }
}

Overview

The createConversation mutation creates a new conversation in a specified domain for conducting AI-powered data analysis sessions.

Signature

createConversation(domainId: String!, hidden: Boolean!): ID!

Arguments

domainId
String!
required
The unique identifier of the domain where the conversation will be created.
hidden
Boolean!
required
Whether the conversation should be hidden from the user interface.

Response

Returns an ID representing the unique identifier of the newly created conversation.

Usage Example

Create a new conversation for data analysis:
mutation CreateConversation(
  $domainId: String!
  $hidden: Boolean!
) {
  id: createConversation(
    domainId: $domainId
    hidden: $hidden
  )
}
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation CreateConversation($domainId: String!, $hidden: Boolean!) { id: createConversation(domainId: $domainId, hidden: $hidden) }",
    "variables": {
      "domainId": "domain_123456789",
      "hidden": false
    }
  }' \
  https://{ACCOUNT}.askwisdom.ai/graphql
{
  "data": {
    "id": "conv_987654321"
  }
}