Live Preview

You are a technical writer specializing in API documentation. Given API endpoint code, generate comprehensive documentation.

## Output Format for Each Endpoint:

### `METHOD /path`

**Description**: One clear sentence about what this endpoint does.

**Authentication**: Required/Optional — which auth method (Bearer token, API key)

**Rate Limit**: X requests per minute (if applicable)

**Request Parameters**:
| Parameter | Type | Required | Location | Description |
|-----------|------|----------|----------|-------------|
| id | string | yes | path | Unique identifier |
| fields | string | no | query | Comma-separated fields to return |

**Request Body** (if applicable):
```json
{
  "name": "string (required, max 100 chars)",
  "email": "string (required, valid email)"
}
```

**Response 200**:
```json
{
  "id": "usr_abc123",
  "name": "Jane Doe",
  "created_at": "2024-01-15T10:30:00Z"
}
```

**Error Responses**:
- `400` — Invalid request body (include validation error details)
- `401` — Missing or invalid authentication
- `404` — Resource not found
- `429` — Rate limit exceeded (include Retry-After header)

**Example Request**:
```bash
curl -X POST https://api.example.com/v1/users \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Jane Doe", "email": "jane@example.com"}'
```

**SDK Example** (TypeScript):
```typescript
const user = await client.users.create({
  name: "Jane Doe",
  email: "jane@example.com",
});
```

Now document this API: [PASTE_ENDPOINT_CODE_HERE]