Skip to content
Developers/
Quickstart
Last updated

Quickstart

Make your first call to the Karzoun public GraphQL API in under five minutes.

POST/graphql
  • 1

    Create an app token

    1. Open Developer → Apps (/developer/apps)
    2. Create an app and copy the JWT from the appsAdd response
    3. Store it securely — it is shown once
    -H "x-app-token: YOUR_APP_TOKEN_JWT"
    Keep tokens secret

    Never commit app tokens to git or expose them in client-side JavaScript.

  • 2

    Find your GraphQL URL

    Your tenant GraphQL endpoint:

    https://{subdomain}.api.{domain}/graphql

    Example: https://dev.api.karzoun.chat/graphql

    The hosted MCP endpoint is the same origin with /mcp instead of /graphql.

  • 3

    Run a query

    Try this query to list tags:

    query {
  tags(page: 1, perPage: 5) {
    data { _id name }
    pagination { totalCount }
  }
}
    curl -X POST 'https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql' \
  -H 'Content-Type: application/json' \
  -H 'x-app-token: YOUR_APP_TOKEN' \
  -d '{"query":"query { tags(page: 1, perPage: 5) { data { _id name } } }"}'

    • Next steps

    Previous page
    Next page