Skip to main content

​
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

EndpointDescription
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

Create Task (POST) → Run Created (pending) → Executing → completed / failed

​
Base URL

https://unpod.dev/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 CodeDescription
200Success - Data fetched successfully
206Partial Content - Business logic error occurred
401Unauthorized - Invalid or missing API token
404Not Found - Space or Run not found
500Internal Server Error - Server-side error