> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeptar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create an API key and make your first Zeptar API request in a couple of minutes.

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:

```text theme={null}
https://api.zeptar.com
```

## Make your first request

<Steps>
  <Step title="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:

    ```bash theme={null}
    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" } }'
    ```
  </Step>

  <Step title="Store the key">
    Keep the key out of your source code. Put it in an environment variable:

    ```bash theme={null}
    export ZEPTAR_API_KEY="zsk_your_key_here"
    ```

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

    ```bash .env theme={null}
    ZEPTAR_API_KEY=zsk_your_key_here
    ```
  </Step>

  <Step title="Call the API">
    List the agents in your workspace. Pass the key as a Bearer token.

    <CodeGroup>
      ```bash curl theme={null}
      curl https://api.zeptar.com/v1/agents \
        -H "Authorization: Bearer $ZEPTAR_API_KEY"
      ```

      ```ts TypeScript theme={null}
      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);
      ```

      ```python Python theme={null}
      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"])
      ```
    </CodeGroup>
  </Step>

  <Step title="Read the response">
    A successful call returns `200 OK` with your agents:

    ```json theme={null}
    {
      "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](/api-reference/authentication) for the details.
  </Step>
</Steps>

## Next steps

<Columns cols={3}>
  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Session cookies, API keys, scopes, and the error shapes to expect.
  </Card>

  <Card title="Create an agent" icon="plus" href="/api-reference/agents/overview">
    Go beyond reading — create and configure agents over the API.
  </Card>

  <Card title="Request log" icon="list" href="/api-reference/request-log/overview">
    Inspect every API call your keys make, with filtering and export.
  </Card>
</Columns>