curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation CreateDomain($input: CreateDomainInput!) { createDomain(input: $input) { id name description } }",
    "variables": {
      "input": {
        "name": "Sales Analytics",
        "description": "Customer data, transactions, and sales performance metrics"
      }
    }
  }' \
  https://{ACCOUNT}.askwisdom.ai/graphql
{
  "data": {
    "createDomain": {
      "id": "ET_DOMAIN_id-here",
      "name": "Sales Analytics",
      "description": "Customer data, transactions, and sales performance metrics"
    }
  }
}

Overview

The createDomain mutation creates a new domain with a name and optional description.

Signature

createDomain(input: CreateDomainInput!): DomainModel!
This mutation can only be executed by an administrator or a data administrator of the specific domain ID.

Arguments

input
CreateDomainInput!
required
Input object containing domain creation parameters. See CreateDomainInput.

CreateDomainInput

name
String!
required
The name of the domain. Must be unique within your organization.
description
String
Optional description explaining the purpose and contents of the domain.

Response

Returns a DomainModel object representing the newly created domain. See DomainModel for the schema.

Usage Example

Create a domain for organizing sales-related data sources:
mutation CreateDomain($input: CreateDomainInput!) {
  createDomain(input: $input) {
    id
    version
    name
    description
  }
}
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation CreateDomain($input: CreateDomainInput!) { createDomain(input: $input) { id name description } }",
    "variables": {
      "input": {
        "name": "Sales Analytics",
        "description": "Customer data, transactions, and sales performance metrics"
      }
    }
  }' \
  https://{ACCOUNT}.askwisdom.ai/graphql
{
  "data": {
    "createDomain": {
      "id": "ET_DOMAIN_id-here",
      "name": "Sales Analytics",
      "description": "Customer data, transactions, and sales performance metrics"
    }
  }
}