list-teamspaces.md

title	List all teamspaces
description	List all teamspaces via Plane API. HTTP GET request with pagination, filtering, and query parameters.
keywords	plane api, list teamspaces, get all teams, team management, workspace teams, rest api, api integration

List all teamspaces

GET /api/v1/workspaces/{workspace_slug}/teamspaces/

Returns a list of all teamspaces in a workspace.

Path Parameters

The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL https://app.plane.so/my-team/projects/, the workspace slug is my-team.

Query Parameters

Number of results to return per page.

Number of results to skip for pagination.

Scopes

teamspaces:read

curl -X GET \
  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/" \
  -H "X-API-Key: $PLANE_API_KEY" \
  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \

import requests

response = requests.get(
    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/",
    headers={"X-API-Key": "your-api-key"}
)
print(response.json())

const response = await fetch(
  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/",
  {
    method: "GET",
    headers: {
      "X-API-Key": "your-api-key"
    }
  }
);
const data = await response.json();

{
  "id": "resource-uuid",
  "created_at": "2024-01-01T00:00:00Z"
}