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

# API Reference

> Complete reference for all KiteFrost Game Narrative API endpoints.

## Base URL

All API requests use the following base URL:

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

## Authentication

All endpoints require a Bearer token. See [Authentication](_shared/core-concepts/auth) for key types and scopes.

## Versioning

The current API version is **v1**. Breaking changes will be introduced under a new version prefix (`/v2/...`) with a minimum 90-day deprecation notice.

## Rate limits

| Plan       | Requests / minute | Requests / day |
| ---------- | ----------------- | -------------- |
| Free       | 60                | 5,000          |
| Pro        | 300               | 50,000         |
| Studio     | 600               | 150,000        |
| Enterprise | 1,200             | Unlimited      |

Rate limit headers are included on every response:

```
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 187
X-RateLimit-Reset: 1742294460
```

When the limit is exceeded you receive `429 Too Many Requests` with a `Retry-After` header.

## Endpoints

<Note>
  The interactive API explorer below is powered by the OpenAPI specification hosted at `https://api.kitefrost.ai/v1/packs/game-narrative/openapi.json`. This host serves only the Game Narrative endpoints plus the shared core; endpoints from other packs are not included. Use your `sk_live_...` key to authenticate directly in the explorer.
</Note>