Teams

Delete Team

Changed on Oct 13, 2026

Delete a team

delete/api/v3/meta/workspaces/{workspaceId}/teams/{teamId}

Request

Base URL
https://app.nocodb.com
Auth
- API key in header xc-token
- or HTTP bearer
TypeScript
https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/workspaces/:workspaceId/teams/:teamId/delete.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

workspaceIdstring required

Workspace ID

teamIdstring required

Team ID

Query parameters

force'true' | 'false'

Set to true to delete a team that has sub-teams. The sub-teams are reparented to the deleted team's parent. Without it, deleting a team that has children is rejected.

Response

Team deleted successfully

msgstring

Example response

{
  "msg": "Team has been deleted successfully"
}

Changes

Oct 13, 20262ba4267a99d7 Revision changes
- warning
  deleted the query request parameter include_workspace
- info
  api operation id teams-delete-v3 removed and replaced with teams-delete
- info
  added the new optional query request parameter force
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history