Skip to main content
You will create a key, call your workspace, and read a list of tags.
1

Create an API key

Open Developer → API keys (/developer/api-keys). Create a personal key, leave the scopes your account is allowed to use, and copy the secret. It starts with kz_live_ and is shown once.
Do not commit the key or paste it into frontend code.
2

Copy your API URL

Replace YOUR_SUBDOMAIN with the subdomain of your workspace. If you sign in at acme.karzoun.chat, the API is:
3

Run this query

The query and the curl below are the same request.
A working key returns JSON like this:
data may be an empty list. That still means the call worked. If you get errors instead, the key was missing, revoked, or the query does not match the schema. See Errors.
The same call works in the Playground while you are signed in. Add the Authorization header there only when you want to test the key rather than your own login.

Next

The raw schema, with no key required, is https://YOUR_SUBDOMAIN.api.karzoun.chat/public-api.graphql.
Last modified on August 9, 2026