Get Task Status

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

Retrieves the current status of an asynchronous task. The shape of task_result depends on the task type. For presentation generation tasks, use the returned request_id with /presentation/download/{request_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.

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 GuzzleHttp\Client;

$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": "<task-specific result>",
  "task_info": "<task-specific info>"
}

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": {}
}