Import a v2 Presentation

POST https://api.slidespeak.co/api/v2/presentation/import

Imports an existing PowerPoint (.pptx) file into your SlideSpeak account. The request is synchronous — the response contains the presentation_id directly, ready to use with /presentation/translate.

Note

Importing is free. A common flow is import → translate: upload your deck once, then translate the returned presentation_id into as many languages as you need.

Headers

---

Content-Type: string

multipart/form-data

X-API-Key: string

The API key to use for the request.

Body Parameters

---

file: file

The PowerPoint file to import. Must be a .pptx file of at most 100 MB.

Code Examples

---

cURL

curl -X POST "https://api.slidespeak.co/api/v2/presentation/import"   -H "X-API-Key: YOUR_API_KEY"   -F "file=@presentation.pptx"

JavaScript

import { readFile } from 'node:fs/promises';

const form = new FormData();
form.append('file', new Blob([await readFile('presentation.pptx')]), 'presentation.pptx');

const response = await fetch('https://api.slidespeak.co/api/v2/presentation/import', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  body: form,
});

const data = await response.json();
console.log(data.presentation_id);

Python

import requests

url = "https://api.slidespeak.co/api/v2/presentation/import"
headers = {"X-API-Key": "YOUR_API_KEY"}

with open("presentation.pptx", "rb") as f:
    response = requests.post(url, headers=headers, files={"file": ("presentation.pptx", f)})

print(response.json()["presentation_id"])

PHP

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client();

$response = $client->post('https://api.slidespeak.co/api/v2/presentation/import', [
    'headers' => [
        'X-API-Key' => 'YOUR_API_KEY'
    ],
    'multipart' => [
        [
            'name' => 'file',
            'contents' => fopen('presentation.pptx', 'r'),
            'filename' => 'presentation.pptx'
        ]
    ]
]);

$data = json_decode($response->getBody(), true);
echo $data['presentation_id'];

Response

---

Error handling

On non-2xx responses, use the error object for stable error codes, retry decisions, and support request ids. See Errors.

200

{
  "presentation_id": "cmgt32cut0000h3ovex8dbzmn"
}

400

{
  "detail": "File must be a .pptx file"
}

413

{
  "detail": "Max file size (100 MB) exceeded. Please contact support for help."
}

Validation

---

• file is required and must be a non-empty .pptx file.
• Files larger than 100 MB are rejected with a 413.
• The imported presentation belongs to the user that owns the API key.