Skip to main content
DELETE
Delete Workspace

Authentication and permissions

Token requirements: User-based token (OAuth) or Organization-scoped API key. Send a bearer access token for one of these identities. The permissions and resource restrictions below also apply.
Permissions joined by + are all required; or separates alternatives. Full-access keys still cannot call endpoints marked unsupported. Workspace keys must allow every workspace checked by the request. OAuth access depends on the user’s roles and resource access.
  • Non-branch workspace: The target workspace is not a branch. User OAuth requires an organization admin. Existing workspace deletion restrictions still apply.
  • Branch workspace: User OAuth requires an organization admin who originally created the branch. Branches with unavailable creator provenance cannot be deleted.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Response

200 - application/json

Success

The response is of type DeleteTeamResponse · object.