Skip to main content
POST
Edit Presentation
Revise a generated Modern artifact with natural-language instructions. Omit slide_ids for a deck-wide edit or include up to 50 slide IDs to scope the change. Uploaded assets can be introduced or reused through asset_ids. Pass the latest repo_commit_sha as base_commit_sha to ensure the edit applies to the revision you read. If the deck has changed, the operation fails instead of overwriting newer work.

Authorizations

Authorization
string
header
required

Your Alai API key. Get one from your account settings at app.getalai.com

Path Parameters

presentation_id
string
required

Body

application/json
instruction
string
required
Required string length: 1 - 20000
slide_ids
string[]
Maximum array length: 50
asset_ids
string[]
Maximum array length: 20
model
ModernApiModelSelection · object | null
base_commit_sha
string | null
Required string length: 7 - 64
idempotency_key
string | null
Required string length: 1 - 128

Response

Successful Response

id
string
required
operation_type
enum<string>
required
Available options:
generate,
edit,
export
presentation_id
string
required
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed
progress
Progress · object | null
result
Result · object | null
error
string | null
created_at
string | null
started_at
string | null
completed_at
string | null