Quickstart

List your agents in five lines of code.

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:

Variable	Where it comes from
KATAVEN_API_KEY	Bearer token. Today this is your Zitadel ID token (long JWT). Long-lived API keys land soon.
KATAVEN_ACCOUNT_ID	Your 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

Python

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

Python

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

• Your first agent — walk through the full configure-and-deploy loop.
• Concepts: Agents — what every field on an agent does.
• API Reference — every endpoint, with try-it.