latestOpenAPI 3.1.0Proprietary - Prezent, Inc.2026-08-114675175.5 KB

a01cb764a085

AutoGenerator

Create an AutoGenerator job

Kicks off a background pipeline that turns the supplied prompt, context files, and assets into a Prezent presentation. Returns a callback_id that the caller polls via GET /api/v1/autogenerator/status?callback_id={callback_id} until status is success or failed.

post/api/v1/autogenerator

Headers

Idempotency-Keystring
Example:8e6df756-18f6-4f16-8e12-7d7a5c5cb181

Optional client-generated key (a UUID is ideal) that makes a write request safe to retry. The first request is processed and its response cached for 24 hours; an identical retry with the same key returns the cached response plus an Idempotency-Replayed: true header, so the job is never created twice. Reusing a key with a different body returns 409 IDEMPOTENCY_KEY_REUSED_WITH_DIFFERENT_BODY.

Request body

promptstring required

Natural-language description of the deck to generate.

textsstring[]

Additional free-text context to ground the deck.

filesstring[]

Previously uploaded supporting files (by id).

web_linksstring[]

Web URLs to ingest as additional context.

template_idstring

Target theme/template id.

Example request

{
  "audience": {
    "id": "aud_9f1b2c2f",
    "num_id": 42,
    "fullName": "Executive Leadership",
    "type": "standard"
  },
  "settings": {
    "template_id": "8f14e45f-ceea-467a-9f1b-2c2f0e3a1b90",
    "ai_model": "astrid_standard",
    "image_preferences": [
      "prezent_library",
      "company_library"
    ],
    "knowledge_base": "uploaded_and_web",
    "data_sources": [
      "add_sources_to_footer",
      "add_sources_to_slides_note"
    ],
    "speaker_notes": [
      "add_speaker_notes",
      "add_speaker_notes_to_slides_note"
    ]
  }
}

Response

Job accepted; client must poll for completion.

messagestring

Human-readable status, for example "Job submitted successfully".

errorstring nullable

Null on success; an error string otherwise.