---
title: AI Presets API - List Saved AI Generation Presets
description: List your saved AI carousel generation presets with the PostNitro Embed API. Returns platform, tone, audience, language, slide count, and model for reuse across generations.
canonical: https://postnitro.ai/docs/embed/api/ai-presets
---

# AI Presets

An **AI preset** is a saved bundle of generation settings — platform, tone,
audience, language, slide count, and model — that you can reuse when generating
carousels instead of re-specifying each option.

Requires the `embed-api-key` header — see
[Authentication](https://postnitro.ai/docs/embed/api/authentication).

---

## List AI presets

```
GET /ai-preset
```

Returns the AI config presets in your workspace, most recently updated first.

### Query parameters

| Parameter | Default | Description |
| --- | --- | --- |
| `page` | `1` | Page number (positive integer). |
| `limit` | `10` | Items per page (`1`–`100`). |

### Response `200`

```jsonc
{
  "success": true,
  "data": {
    "presets": [
      {
        "id": "preset_123",
        "socialPlatform": "linkedin",
        "tone": "professional",
        "audience": "founders",
        "language": "en",
        "slides": 8,
        "model": "claude-opus-4-8"
      }
    ]
  }
}
```

| Field | Description |
| --- | --- |
| `id` | Preset id. |
| `socialPlatform` | Target platform the preset is tuned for. |
| `tone` | Writing tone applied to generated copy. |
| `audience` | Target audience for the content. |
| `language` | Output language. |
| `slides` | Default number of slides. |
| `model` | AI model used for generation. |

### Errors

| Status | Body | When |
| --- | --- | --- |
| `404` | `{ "success": false, "message": "No AI Config Presets found" }` | The workspace has no presets. |
| `422` | `{ "status": false, "message": "Page must be a positive integer" }` | Invalid `page`. |
| `422` | `{ "status": false, "message": "Limit must be between 1 and 100" }` | Invalid `limit`. |
| `500` | `{ "success": false, "message": "Error fetching AI Config Presets", ... }` | Unexpected server error. |

See [Authentication](https://postnitro.ai/docs/embed/api/authentication) for `401` / `402` responses.