Skip to main content

​
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

EndpointDescription
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.dev/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 CodeDescription
200Success - Request completed successfully
401Unauthorized - Invalid or missing API token
403Forbidden - Access denied to the resource
404Not Found - Space or Organization not found
500Internal Server Error - Server-side error