delete-teamspace.md

title	Delete a teamspace
description	Delete a teamspace via Plane API. Removes the team grouping and disassociates its members and projects. Returns 204 on success.
keywords	plane api, delete teamspace, remove team, team management, workspace teams, rest api, api integration

Delete a teamspace

DELETE /api/v1/workspaces/{workspace_slug}/teamspaces/{teamspace_id}/

Deletes a teamspace

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.

The unique identifier for the teamspace.

Scopes

teamspaces:write

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

import requests

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

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

// 204 No Content