Spaces API

The Spaces API allows you to manage and retrieve spaces (workspaces/groups) in your Unpod platform. Spaces are containers that organize your tasks, runs, and data collections.

Prerequisites: Make sure you have your API Token and Org-Handle ready. See Authentication for details.

What You Can Do

Endpoint	Description
`GET /api/v2/platform/spaces/`	Retrieve all spaces in your organization
`GET /api/v2/platform/spaces/{space_token}/`	Retrieve a specific space by its token
`GET /api/v2/platform/spaces/{space_token}/tasks/`	Retrieve all tasks within a specific space

Base URL

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

Authentication

All Spaces API requests require a valid API token and Org-Handle in the headers:

Authorization: Token your-api-token
Org-Handle: your-org-handle

You can get the Org-Handle by hitting the Get All Organizations API. The domain_handle field in the response is your Org-Handle.

Common Error Codes

Status Code	Description
200	Success - Request completed successfully
401	Unauthorized - Invalid or missing API token
403	Forbidden - Access denied to the resource
404	Not Found - Space or Organization not found
500	Internal Server Error - Server-side error

Get All SpacesRetrieve details of all created spaces in your organization

Getting Started

API Lists

Overview

Spaces API

What You Can Do

Base URL

Authentication

Common Error Codes

​Spaces API

​What You Can Do

​Base URL

​Authentication

​Common Error Codes

Spaces API

What You Can Do

Base URL

Authentication

Common Error Codes