Karzoun Docs

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

Create an app token

Open Developer → Apps (/developer/apps)
Create an app and copy the JWT from the appsAdd response
Store it securely — it is shown once

Send the token on every request:

-H "x-app-token: YOUR_APP_TOKEN_JWT"

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

Find your GraphQL URL

Your tenant GraphQL endpoint:

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

Example: https://dev.api.karzoun.chat/graphqlThe hosted MCP endpoint is the same origin with /mcp instead of /graphql.Download the public schema (SDL, no auth):

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

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

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 } } }"}'

Prefer a visual editor? Open the GraphQL Playground.

Next steps

Last modified on August 9, 2026

Getting started

Guides

Try it

Quickstart

Next steps

​Next steps

Next steps