Runs & Executions API

The Runs API allows you to manage and monitor execution runs in your Unpod platform. A run represents a batch execution - a group of tasks triggered together within a space.

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

What You Can Do

Endpoint	Description
`GET /api/v2/platform/spaces/{space_token}/runs/`	Retrieve all batch runs in a space
`GET /api/v2/platform/spaces/{space_token}/runs/{run_id}/tasks/`	Retrieve all tasks for a specific run

Run Lifecycle

Animated platform execution lifecycle diagram showing task creation, pending state, execution, and completed or failed outcomes.

Base URL

https://unpod.ai/api/v2/platform/

Authentication

All Runs API requests require a valid API token in the headers:

Authorization: Token your-api-token
Content-Type: application/json

Common Error Codes

Status Code	Description
200	Success - Data fetched successfully
206	Partial Content - Business logic error occurred
401	Unauthorized - Invalid or missing API token
404	Not Found - Space or Run not found
500	Internal Server Error - Server-side error

Get All Runs in a SpaceRetrieve all batch executions associated with a specific space

Getting Started

API Lists

Overview

Runs & Executions API

What You Can Do

Run Lifecycle

Base URL

Authentication

Common Error Codes

​Runs & Executions API

​What You Can Do

​Run Lifecycle

​Base URL

​Authentication

​Common Error Codes

Runs & Executions API

What You Can Do

Run Lifecycle

Base URL

Authentication

Common Error Codes