Get Task Status

GET https://api.slidespeak.co/api/v1/task_status/{{task_id}}

Retrieves the current status of an asynchronous task. When the task completes, the response includes a request_id inside task_result. Use that request_id with /presentation/download/{id} to obtain a short‑lived URL.

Headers

---

Content-Type: string

application/json

X-API-Key: string

The API key to use for the request.

<YOUR_API_KEY>

Get Parameters

---

task_id: string

The ID you get after starting a task.

Code Examples

---

cURL

curl -X GET "https://api.slidespeak.co/api/v1/task_status/9649d202-03ac-437a-80e8-ff91ff4ace67"   -H "Content-Type: application/json"   -H "X-API-Key: YOUR_API_KEY"

JavaScript

fetch('https://api.slidespeak.co/api/v1/task_status/9649d202-03ac-437a-80e8-ff91ff4ace67', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  }
})
  .then(response => response.json())
  .then(data => {
    console.log('Task status:', data);
  })
  .catch(error => {
    console.error('Error:', error);
  });

Python

import requests

url =
"https://api.slidespeak.co/api/v1/task_status/9649d202-03ac-437a-80e8-ff91ff4ace67"
headers = { "Content-Type": "application/json", "X-API-Key": "YOUR_API_KEY" }

response = requests.get(url, headers=headers)
print(response.json())

PHP

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

use GuzzleHttpClient;

$client = new Client();

$response = $client->get('https://api.slidespeak.co/api/v1/task_status/9649d202-03ac-437a-80e8-ff91ff4ace67', [
    'headers' => [
        'Content-Type' => 'application/json',
        'X-API-Key' => 'YOUR_API_KEY'
    ]
]);

$body = $response->getBody();
$data = json_decode($body, true);

print_r($data);

Response

---

SUCCESS

{
  "task_id": "351ceb47-1377-4641-a5ff-420816a84ba9",
  "task_status": "SUCCESS",
  "task_result": {
    "url": "https://slidespeak-files.s3.us-east-2.amazonaws.com/example.pptx",
    "request_id": "cr5abc123..."
  },
  "task_info": {
    "url": "https://slidespeak-files.s3.us-east-2.amazonaws.com/example.pptx",
    "request_id": "cr5abc123..."
  }
}

Caution

Deprecation notice: task_info and the permanent url in task_result will be removed to improve security. Always use the request_id with /presentation/download/{id} to get a short‑lived URL.

SENT

{
    "task_id": "9649d202-03ac-437a-80e8-ff91ff4ace67",
    "task_status": "SENT",
    "task_result": null,
    "task_info": null
}

FAILURE

{
  "task_id": "9649d202-03ac-437a-80e8-ff91ff4ace67",
  "task_status": "FAILURE",
  "task_result": "<error_message>",
  "task_info": {},
}