# [API Name] Documentation

Version [v1] · Last updated [date]

## Overview

[What the API does and who it is for.]

- **Base URL:** [https://api.example.com/v1]
- **Format:** JSON
- **Support:** [email or link]

## Authentication

[Describe how to get and use credentials, e.g. send your API key in the Authorization header.]

```
Authorization: Bearer [YOUR_API_KEY]
```

## Endpoint: [List items]

```
GET /[items]
```

[Short description of what the endpoint returns.]

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| limit | integer | No | [Number of results to return (default 20, max 100)] |
| cursor | string | No | [Cursor for the next page of results] |

**Example request**

```bash
curl https://api.example.com/v1/[items]?limit=2 \
  -H "Authorization: Bearer [YOUR_API_KEY]"
```

**Example response** (200 OK)

```json
{
  "data": [
    { "id": "itm_123", "name": "[Example]", "created_at": "2027-03-01T12:00:00Z" }
  ],
  "next_cursor": "[abc123]"
}
```

## Endpoint: [Create item]

```
POST /[items]
```

**Body parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| name | string | Yes | [Description] |
|  |  |  |  |

## Errors

| Status code | Meaning | What to do |
| --- | --- | --- |
| 400 | Bad request | Check required fields and formats |
| 401 | Unauthorized | Check your API key |
| 403 | Forbidden | Your key lacks permission for this action |
| 404 | Not found | Check the resource ID or URL |
| 429 | Too many requests | Slow down; retry after the time in the Retry-After header |
| 500 | Server error | Retry later; contact support if it continues |

## Rate limits

[e.g. 100 requests per minute per API key. Limits are returned in X-RateLimit headers.]

## Changelog

| Date | Version | Change |
| --- | --- | --- |
|  |  |  |
|  |  |  |
