Skip to main content

Documentation Index

Fetch the complete documentation index at: https://katavenai.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

This page walks you from “I have a Kataven account” to “I’ve called the API.” Pick a language and copy.

​
1. Get credentials

You need two things:
VariableWhere it comes from
KATAVEN_API_KEYBearer token. Today this is your Zitadel ID token (long JWT). Long-lived API keys land soon.
KATAVEN_ACCOUNT_IDYour account slug (e.g. acme). Visible in the dashboard URL.
Set both as env vars so the SDKs can pick them up automatically. 
export KATAVEN_API_KEY="eyJhbGciOiJSUzI1NiIs..."
export KATAVEN_ACCOUNT_ID="acme"
API keys are on the roadmap. Today you obtain a JWT by signing into the dashboard and copying it from devtools. Once long-lived API keys ship, the same Authorization: Bearer … header will accept either — no SDK changes required.

​
2. List your agents

from kataven import KatavenClient

client = KatavenClient()  # picks up env vars
for agent in client.agents.list():
    print(agent["id"], agent["name"])

​
3. Create an agent

agent = client.agents.create(
    name="Front Desk",
    description="Greets callers and books appointments.",
    system_prompt="You are a friendly receptionist for Acme Co.",
    greeting_message="Thanks for calling Acme. How can I help?",
    llm_model="gpt-4o",
    voice_provider="cartesia",
    voice_id="a0e99841-438c-4a64-b679-ae501e7d6091",
)
print("Created:", agent["id"])

​
4. Wire up Claude (optional)

If you want Claude to drive Kataven for you — “Claude, create a sales agent that knows about our pricing tiers” — install the MCP server and Claude can call the API itself without you writing code.

​
What’s next