---
title: "Delete Team"
method: POST
path: "/api/metrics/developer/teams/delete"
tags: ["Developer Metrics - Teams"]
---

# Delete Team

`POST /api/metrics/developer/teams/delete`

Deletes a team. By default performs a **soft delete** (marks the team as inactive). Set `hard_delete: true` to permanently remove the team and its data.

## Request body

- DeleteTeamRequest
  - `platform` 'github' | 'gitlab' | 'bitbucket' | 'azure_devops' | 'azuredevops', required — Version control platform
  - `org` string, required — Organization, workspace, or group name on the platform
  - `github_base_url` string — Base URL for GitHub (use for GitHub Enterprise Server)
  - `gitlab_base_url` string — Base URL for GitLab (use for self-hosted GitLab instances)
  - `azure_devops_base_url` string — Base URL for Azure DevOps (use for Azure DevOps Server)
  - `bitbucket_base_url` string — Base URL for Bitbucket (use for Bitbucket Data Center/Server)
  - `team_id` string, uuid, required — ID of the team to delete
  - `hard_delete` boolean — If true, permanently removes the team. If false (default), soft-deletes by marking inactive.

## Response `200`

Team deleted

- DevMetricsStatusResponse
  - `status` 'success' | 'error'
  - `message` string — Human-readable status message

## Other responses

- `400` — Bad request - missing or invalid parameters
- `401` — Unauthorized - missing, invalid, or insufficient access token
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.dev/codeant/apis/codeant-ai-api.md) · [All operations](https://skmtc.dev/codeant/apis/codeant-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/codeant/codeant-ai-api/revisions/d1eb7c083a39/schema)