Skip to main content
POST
/
api
/
v1
/
presentations
/
{presentation_id}
/
slides
Add a slide to an existing presentation
curl --request POST \
  --url https://slides-api.getalai.com/api/v1/presentations/{presentation_id}/slides \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "slide_context": "<string>",
  "options": {
    "additional_instructions": "<string>",
    "slide_order": 123,
    "total_variants_per_slide": 1,
    "num_image_variants": 0
  },
  "export_formats": [
    "link"
  ]
}
'
{
  "generation_id": "<string>"
}
Add a slide to an existing presentation. This is an async operation - poll the returned generation_id for completion.

​
Path Parameters

ParameterTypeDescription
presentation_idstringID of the presentation to add the slide to

​
Request Body

ParameterTypeDefaultDescription
slide_contextstring(required)Content for this slide
options.additional_instructionsstring-Extra instructions for slide generation
options.slide_orderinteger(end)Position in presentation (0-indexed)
options.total_variants_per_slideinteger1Variants to generate (1-4)
options.num_image_variantsinteger0Image slide variants (0-2)
export_formatsarray["link"]Formats to export: link, pdf, ppt

​
Response

{
  "generation_id": "abc123-def456-..."
}
Poll GET /generations/{generation_id} until status is completed. The response will include slide_id.

​
Example

curl -X POST "https://slides-api.getalai.com/api/v1/presentations/xyz789-.../slides" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slide_context": "Key achievements: 25% revenue growth, 50 new clients",
    "options": {
      "additional_instructions": "Make it visual with icons"
    }
  }'

​
Status Response

When polling, the status response includes slide_id: 
{
  "generation_id": "abc123-...",
  "generation_type": "slide_creation",
  "status": "completed",
  "presentation_id": "xyz789-...",
  "slide_id": "slide123-...",
  "formats": {
    "link": {
      "status": "completed",
      "url": "https://app.getalai.com/view/..."
    }
  }
}

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
​
slide_context
string
required

Content for this slide.

​
options
CreateSlideOptions · object
​
export_formats
enum<string>[]

The formats in which the generation will make the slide available

Available options:
link,
pdf,
ppt

Response

Successful Response

​
generation_id
string
required

Unique identifier to poll for generation status via GET /generations/{generation_id}