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

# Quickstart

> Make your first Neo API request — create a key, list your agents, and read the response.

This walks you from zero to a working API call in a couple of minutes.

<Steps>
  <Step title="Create an API key">
    In the dashboard, open [**Roles & Access** → **API Keys**](https://dashboard.neoagent.io/rbac?tab=api-keys), click **Create API key**, and copy the key — it's shown only once. See [Authentication](/developers/authentication) for the details.
  </Step>

  <Step title="Make your first request">
    List your agents. Swap in the key you just copied:

    ```bash theme={null}
    curl https://api.neoagent.io/public-api/agents \
      -H "Authorization: Bearer neo_sk_prod_AbCdEf0123456789AbCdEf01"
    ```
  </Step>

  <Step title="Read the response">
    A successful response wraps the result in the standard envelope — your data in `data`, request metadata and pagination in `meta`:

    ```json theme={null}
    {
      "data": [
        {
          "agent_id": "1042",
          "agent_name": "Ticket Triage",
          "autonomy_type": "AGENTIC",
          "enabled": true
        }
      ],
      "meta": {
        "request_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
        "pagination": { "has_more": false, "next_cursor": null }
      }
    }
    ```

    Every list response carries `meta.request_id` (quote it if you contact support) and `meta.pagination`.
  </Step>
</Steps>

## Paginate through a list

List endpoints return up to `page_size` items (default 50, max 200). When `meta.pagination.has_more` is `true`, pass the `next_cursor` back as the `cursor` query parameter to fetch the next page:

```bash theme={null}
curl "https://api.neoagent.io/public-api/agents?page_size=100&cursor=eyJpZCI6MTA0Mn0" \
  -H "Authorization: Bearer neo_sk_prod_AbCdEf0123456789AbCdEf01"
```

Keep following `next_cursor` until `has_more` is `false`.

## Explore the endpoints

The full, always-current API reference — every endpoint with its parameters, request and response schemas, and a built-in request console — lives under **Endpoints** in the sidebar. A few common starting points:

| Resource          | Endpoint                                     |
| ----------------- | -------------------------------------------- |
| List your agents  | `GET /public-api/agents`                     |
| Inspect one agent | `GET /public-api/agents/{agent_id}`          |
| Run an agent now  | `POST /public-api/agents/{agent_id}/run-now` |
| List executions   | `GET /public-api/executions`                 |
| Read credit usage | `GET /public-api/billing/usage`              |

## What's next

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/developers/authentication">
    Key creation, rotation, revocation, and best practices.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/developers/errors">
    The error envelope and what each status means.
  </Card>

  <Card title="Rate limits" icon="gauge-high" href="/developers/rate-limits">
    How much you can call, and the headers that tell you.
  </Card>

  <Card title="Neo API agent tool" icon="robot" href="/agents/tools/management/neo-api">
    Let an agent call this same API from inside a workflow.
  </Card>
</CardGroup>