Quickstart

This guide takes you from zero to a working API call: you’ll create an API key, store it, and list the agents in your workspace.

Before you start

You need a Zeptar workspace and the ability to create an API key in it. All requests go to:

https://api.zeptar.com

Make your first request

Create an API key

In the dashboard, open ZeptarAPI → API keys and choose Create API key. Give it a name and grant at least agents: read. Copy the key — it starts with zsk_ and is shown only once.Prefer the API? Create one with a session cookie:

curl https://api.zeptar.com/v1/api-keys \
  -H "Cookie: better-auth.session_token=…" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Quickstart", "scopes": { "agents": "read" } }'

Store the key

Keep the key out of your source code. Put it in an environment variable:

export ZEPTAR_API_KEY="zsk_your_key_here"

Or add it to a .env file your app loads at startup:

.env

ZEPTAR_API_KEY=zsk_your_key_here

Call the API

List the agents in your workspace. Pass the key as a Bearer token.

curl https://api.zeptar.com/v1/agents \
  -H "Authorization: Bearer $ZEPTAR_API_KEY"

const res = await fetch("https://api.zeptar.com/v1/agents", {
  headers: { Authorization: `Bearer ${process.env.ZEPTAR_API_KEY}` },
});

const { agents } = await res.json();
console.log(agents);

import os, requests

res = requests.get(
    "https://api.zeptar.com/v1/agents",
    headers={"Authorization": f"Bearer {os.environ['ZEPTAR_API_KEY']}"},
)
print(res.json()["agents"])

Read the response

A successful call returns 200 OK with your agents:

{
  "agents": [
    {
      "id": "agt_8f2c…",
      "name": "Support concierge",
      "created_at": "2026-05-20T09:14:00.000Z"
    }
  ]
}

A missing or invalid key returns 401 Unauthorized; a key without the required scope returns 403 insufficient_scope. See Authentication for the details.

Next steps

Authentication

Session cookies, API keys, scopes, and the error shapes to expect.

Create an agent

Go beyond reading — create and configure agents over the API.

Request log

Inspect every API call your keys make, with filtering and export.

Introduction Authentication

Get started

Agents

Dashboard

API keys

Request log

Workspaces

Workspace invitations

Me

Voices

Billing

Integrations

LLMs

Knowledge base

Pronunciation Dictionaries

Before you start

Make your first request

Next steps

Authentication

Create an agent

Request log

​Before you start

​Make your first request

​Next steps

Authentication

Create an agent

Request log

Before you start

Make your first request

Next steps