GET

api

platform

spaces

{space_token}

runs

{run_id}

tasks

Get Detailed Tasks for a Specific Run

curl --request GET \
  --url https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/ \
  --header 'Authorization: <api-key>' \
  --header 'Org-Handle: <org-handle>'

import requests

url = "https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/"

headers = {
    "Org-Handle": "<org-handle>",
    "Authorization": "<api-key>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'Org-Handle': '<org-handle>', Authorization: '<api-key>'}
};

fetch('https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Org-Handle: <org-handle>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Org-Handle", "<org-handle>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "count": 9,
  "status_code": 200,
  "message": "Tasks Fetched Successfully",
  "data": [
    {
      "_id": "697debb84c27faa892bfa0cc",
      "thread_id": "thread_9xkL2mQpR7vNwY4sZ3cJ8hF1",
      "user_info": {
        "email": "user@example.com",
        "full_name": "John Doe"
      },
      "task_id": "T8ff2ccdffe9a11f0878d43cd8a99e069",
      "run_id": "Recac64fe03e911f1878d43cd8a99e069",
      "task": {
        "objective": "Call the lead and discuss the project requirements."
      },
      "input": {
        "name": "John Doe",
        "contact_number": "1234567890",
        "email": "john@example.com",
        "context": "Follow up on proposal"
      },
      "output": {
        "call_id": "CALL_7dAb3kR9mXvQ2pLw",
        "start_time": "2026-02-07T05:57:45Z",
        "end_time": "2026-02-07T06:02:30Z",
        "duration": 285,
        "recording_url": "https://cdn.unpod.ai/recordings/CALL_7dAb3kR9mXvQ2pLw.mp3",
        "transcript": [
          {
            "role": "agent",
            "content": "Hello, this is an AI assistant calling on behalf of Unpod. Am I speaking with John Doe?"
          },
          {
            "role": "user",
            "content": "Yes, this is John."
          }
        ],
        "post_call_data": {
          "summary": "The agent successfully connected with John Doe and discussed project requirements.",
          "outcome": "interested",
          "sentiment": "positive"
        },
        "call_type": "outbound",
        "call_status": "completed"
      },
      "assignee": "space-agent-8qmk42nslp91wrh3dz7btxc4",
      "status": "completed",
      "execution_type": "call",
      "created": "2026-02-07T05:57:45Z",
      "modified": "2026-02-07T06:02:35Z"
    }
  ]
}

{
  "message": "Error retrieving run tasks",
  "errors": "Detailed error description"
}

{
  "count": 9,
  "status_code": 200,
  "message": "Tasks Fetched Successfully",
  "data": [
    {
      "_id": "697debb84c27faa892bfa0cc",
      "thread_id": "thread_9xkL2mQpR7vNwY4sZ3cJ8hF1",
      "user_info": {
        "email": "user@example.com",
        "full_name": "John Doe"
      },
      "task_id": "T8ff2ccdffe9a11f0878d43cd8a99e069",
      "run_id": "Recac64fe03e911f1878d43cd8a99e069",
      "task": {
        "objective": "Call the lead and discuss the project requirements."
      },
      "input": {
        "name": "John Doe",
        "contact_number": "1234567890",
        "email": "john@example.com",
        "context": "Follow up on proposal"
      },
      "output": {
        "call_id": "CALL_7dAb3kR9mXvQ2pLw",
        "start_time": "2026-02-07T05:57:45Z",
        "end_time": "2026-02-07T06:02:30Z",
        "duration": 285,
        "recording_url": "https://cdn.unpod.ai/recordings/CALL_7dAb3kR9mXvQ2pLw.mp3",
        "transcript": [
          {
            "role": "agent",
            "content": "Hello, this is an AI assistant calling on behalf of Unpod. Am I speaking with John Doe?"
          },
          {
            "role": "user",
            "content": "Yes, this is John."
          }
        ],
        "post_call_data": {
          "summary": "The agent successfully connected with John Doe and discussed project requirements.",
          "outcome": "interested",
          "sentiment": "positive"
        },
        "call_type": "outbound",
        "call_status": "completed"
      },
      "assignee": "space-agent-8qmk42nslp91wrh3dz7btxc4",
      "status": "completed",
      "execution_type": "call",
      "created": "2026-02-07T05:57:45Z",
      "modified": "2026-02-07T06:02:35Z"
    }
  ]
}

{
  "message": "Error retrieving run tasks",
  "errors": "Detailed error description"
}

Get Detailed Tasks for a Specific Run

Fetch all tasks for a specific run, including complete input, output, call transcript, costs, analysis, artifacts, and provider metadata. This endpoint is used when you need deep inspection of how a run executed each task.

Prerequisites: Make sure you have your API Token ready. See Authentication for details.

Path Parameters

Name	Type	Required	Description
space_token	string	Yes	Public token of the space
run_id	string	Yes	The run ID whose tasks to retrieve

You can get the space_token from the Get All Spaces API. The run_id can be obtained from the Get All Runs API response.

Headers

Name	Type	Required	Description
Authorization	string	Yes	API Key format: `Token <token>`
Content-Type	string	Yes	`application/json`

Response Fields

Field	Type	Description
count	integer	Total number of tasks
status_code	integer	HTTP status code
message	string	Response message
data	array	Array of task objects

Task Object Fields

Field	Type	Description
_id	string	Internal task document ID
thread_id	string	Thread identifier
user_info	object	User details (email, full_name)
task_id	string	Unique task identifier
run_id	string	Parent run identifier
task	object	Task definition with objective
input	object	Input data for the task
output	object	Task output including call details
assignee	string	Agent handle assigned to the task
status	string	Task status: `pending`, `completed`, `failed`
execution_type	string	Type of execution: `call`, `email`, etc.
created	string	Task creation timestamp
modified	string	Last modified timestamp

Output Object Fields

Field	Type	Description
call_id	string	Unique call identifier
start_time	string	Call start timestamp
end_time	string	Call end timestamp
duration	number	Call duration in seconds
recording_url	string	URL to call recording
transcript	array	Array of conversation messages
post_call_data	object	Post-call analysis data
call_type	string	Direction: `outbound`, `inbound`
call_status	string	Status of the call

Common Error Codes

Status Code	Description
200	Success - Data fetched successfully
206	Partial Content - Business logic error occurred
400	Bad Request - Invalid parameters provided
401	Unauthorized - Invalid or missing API token
403	Forbidden - Access denied to the resource
404	Not Found - Space or Run not found
500	Internal Server Error - Server-side error

Code Examples

const axios = require('axios');

const headers = {
  'Authorization': 'Token your-api-token',
  'Content-Type': 'application/json'
};

// Get tasks for a specific run
const getRunTasks = async (spaceToken, runId) => {
  const response = await axios.get(
    `https://unpod.ai/api/v2/platform/spaces/${spaceToken}/runs/${runId}/tasks/`,
    { headers }
  );
  console.log(`Total tasks: ${response.data.count}`);
  response.data.data.forEach(task => {
    console.log(`Task ${task.task_id}: ${task.status}`);
    if (task.output?.duration) {
      console.log(`  Duration: ${task.output.duration}s`);
    }
  });
  return response.data.data;
};

// Example usage
getRunTasks('8KZAMRAHSXXXXXXMAYNASMJC', 'Recac64fe03e911f1878d43cd8a99e069');

import requests

headers = {
    'Authorization': 'Token your-api-token',
    'Content-Type': 'application/json'
}

def get_run_tasks(space_token: str, run_id: str):
    """Get all tasks for a specific run"""
    url = f'https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/'
    response = requests.get(url, headers=headers)
    data = response.json()
    print(f"Total tasks: {data['count']}")
    for task in data['data']:
        print(f"Task {task['task_id']}: {task['status']}")
        if task.get('output', {}).get('duration'):
            print(f"  Duration: {task['output']['duration']}s")
    return data['data']

# Example usage
get_run_tasks('8KZAMRAHSXXXXXXMAYNASMJC', 'Recac64fe03e911f1878d43cd8a99e069')

# Get tasks for a specific run
curl -X GET "https://unpod.ai/api/v2/platform/spaces/8KZAMRAHSXXXXXXMAYNASMJC/runs/Recac64fe03e911f1878d43cd8a99e069/tasks/" \
  -H "Authorization: Token your-api-token" \
  -H "Content-Type: application/json"

Best Practices

Run ID: Always retrieve the run_id from the Get All Runs endpoint first
Transcript Review: Use the transcript array in output for conversation quality analysis
Recording Access: Store recording_url for compliance, QA, and playback
Post-call Data: Check post_call_data.summary for AI-generated call summaries and outcomes
Error Handling: Always handle potential errors and edge cases
Security: Keep API tokens secure and rotate them regularly

Authorizations

Authorization

string

header

required

Format: Token

Headers

Org-Handle

string

required

Organization domain handle

Example:

"unpod.tv"

Path Parameters

space_token

string

required

Example:

"8KZAMRAHSXXXXXXMAYNASMJC"

run_id

string

required

Example:

"Recac64fe03e911f1878d43cd8a99e069"

Response

List of tasks for the run

OverviewIntroduction to the Call Detail Records (CDR) API

Get Detailed Tasks for a Specific Run

curl --request GET \
  --url https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/ \
  --header 'Authorization: <api-key>' \
  --header 'Org-Handle: <org-handle>'

import requests

url = "https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/"

headers = {
    "Org-Handle": "<org-handle>",
    "Authorization": "<api-key>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'Org-Handle': '<org-handle>', Authorization: '<api-key>'}
};

fetch('https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Org-Handle: <org-handle>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Org-Handle", "<org-handle>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "count": 9,
  "status_code": 200,
  "message": "Tasks Fetched Successfully",
  "data": [
    {
      "_id": "697debb84c27faa892bfa0cc",
      "thread_id": "thread_9xkL2mQpR7vNwY4sZ3cJ8hF1",
      "user_info": {
        "email": "user@example.com",
        "full_name": "John Doe"
      },
      "task_id": "T8ff2ccdffe9a11f0878d43cd8a99e069",
      "run_id": "Recac64fe03e911f1878d43cd8a99e069",
      "task": {
        "objective": "Call the lead and discuss the project requirements."
      },
      "input": {
        "name": "John Doe",
        "contact_number": "1234567890",
        "email": "john@example.com",
        "context": "Follow up on proposal"
      },
      "output": {
        "call_id": "CALL_7dAb3kR9mXvQ2pLw",
        "start_time": "2026-02-07T05:57:45Z",
        "end_time": "2026-02-07T06:02:30Z",
        "duration": 285,
        "recording_url": "https://cdn.unpod.ai/recordings/CALL_7dAb3kR9mXvQ2pLw.mp3",
        "transcript": [
          {
            "role": "agent",
            "content": "Hello, this is an AI assistant calling on behalf of Unpod. Am I speaking with John Doe?"
          },
          {
            "role": "user",
            "content": "Yes, this is John."
          }
        ],
        "post_call_data": {
          "summary": "The agent successfully connected with John Doe and discussed project requirements.",
          "outcome": "interested",
          "sentiment": "positive"
        },
        "call_type": "outbound",
        "call_status": "completed"
      },
      "assignee": "space-agent-8qmk42nslp91wrh3dz7btxc4",
      "status": "completed",
      "execution_type": "call",
      "created": "2026-02-07T05:57:45Z",
      "modified": "2026-02-07T06:02:35Z"
    }
  ]
}

{
  "message": "Error retrieving run tasks",
  "errors": "Detailed error description"
}

Getting Started

API Lists

Get Detailed Tasks for a Specific Run

Get Detailed Tasks for a Specific Run

Path Parameters

Headers

Response Fields

Task Object Fields

Output Object Fields

Common Error Codes

Code Examples

Best Practices

Authorizations

Headers

Path Parameters

Response

​Get Detailed Tasks for a Specific Run

​Path Parameters

​Headers

​Response Fields

​Task Object Fields

​Output Object Fields

​Common Error Codes

​Code Examples

​Best Practices

Authorizations

Headers

Path Parameters

Response

Get Detailed Tasks for a Specific Run

Path Parameters

Headers

Response Fields

Task Object Fields

Output Object Fields

Common Error Codes

Code Examples

Best Practices