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

# API overview

> The NextIntent management API at api.nextintent.ai/v1: websites, switches, the facts sheet, the views, and API keys, per account.

The management API is how a program does what the console and the Shopify app do: create and configure websites, write the facts sheet, and read the views. It is the same API the Shopify app runs on. Storefront traffic (the SDK, the cart beacon, the card) goes to `sdk.nextintent.ai` and is described under [Developers](/api/overview), not here.

## Base URL

```
https://api.nextintent.ai/v1
```

The live contract is served at `https://api.nextintent.ai/v1/openapi.json`, the one route that needs no token. This reference is generated from a copy of it.

## What is here

| Group | Routes | Scope |
| - | - | - |
| Websites | list, create, read, update, delete | `sites:read`, `sites:write` |
| Facts | read, replace | `facts:read`, `facts:write` |
| Views | store, reasons, moments | `sites:read` |
| Keys | list, create, revoke | console session only |

## Conventions

* JSON in and out. Timestamps are UTC ISO strings.
* Errors are `{ "error": "..." }` with a 4xx status. A refused site (not yours, or not found) is a 404, never a 403, so the API does not confirm that a site id exists.
* Website ids are the same `site_id` the SDK script tag uses.
* Rate limits: 600 requests a minute per key, 60 a minute per IP before authentication. Over the limit answers 429.

## Related

* [Authentication](/api/reference/authentication)
* [The facts sheet](/api/facts-sheet)
* [Developer overview](/api/overview)