Skip to Content
EmbedEmbed APIAI 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.

List AI presets

GET /ai-preset

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

Query parameters

ParameterDefaultDescription
page1Page number (positive integer).
limit10Items per page (1–100).

Response 200

{
  "success": true,
  "data": {
    "presets": [
      {
        "id": "preset_123",
        "socialPlatform": "linkedin",
        "tone": "professional",
        "audience": "founders",
        "language": "en",
        "slides": 8,
        "model": "claude-opus-4-8"
      }
    ]
  }
}
FieldDescription
idPreset id.
socialPlatformTarget platform the preset is tuned for.
toneWriting tone applied to generated copy.
audienceTarget audience for the content.
languageOutput language.
slidesDefault number of slides.
modelAI model used for generation.

Errors

StatusBodyWhen
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 for 401 / 402 responses.

Last updated on
TemplatesMCP Server