Get Task Status

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

Retrieves the current status and result of an asynchronous task, such as presentation generation or document processing. Use the task ID returned from other endpoints to poll for progress, completion, or errors. The response includes the task’s status, result, and any additional information.

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": "9649d202-03ac-437a-80e8-ff91ff4ace67",
    "task_status": "SUCCESS",
    "task_result": ...,
    "task_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": {},
}