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.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.Authorization header there only when you want to test the key rather than your own login.
Next
- Authentication — personal and workspace keys, and what a key is allowed to call
- Pagination — walk the rest of a list
- GraphQL API reference — every public query and mutation
https://YOUR_SUBDOMAIN.api.karzoun.chat/public-api.graphql.