> ## Documentation Index > Fetch the complete documentation index at: https://docs.codeant.ai/llms.txt > Use this file to discover all available pages before exploring further. # Delete Team > 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. ## OpenAPI ````yaml /openapi.json post /api/metrics/developer/teams/delete openapi: 3.0.3 info: title: CodeAnt AI API description: >- API for code analysis (SAST, SCA, secrets, IaC) and developer productivity metrics. Supports GitHub, GitLab, Bitbucket, and Azure DevOps. version: 1.0.0 servers: - url: https://api.codeant.ai description: Production server security: [] tags: - name: Analysis description: Code analysis operations - name: Agent Analysis description: >- AI-powered agent analysis operations. Uses LLM-based code exploration agents to perform deep security threat hunting, bug finding, and custom analysis with reflection-based false positive filtering. - name: Developer Metrics - Teams description: >- Manage developer teams: create, update, delete teams and manage team membership. Teams are used to organize developers and scope metrics. - name: Developer Metrics description: >- Developer productivity and activity metrics: active developers, PR throughput, individual comparisons, and AI-generated summaries. All endpoints support GitHub, GitLab, Bitbucket, and Azure DevOps. - name: Audit Logs description: >- Read-only access to your organization's audit trail for compliance, ETL and SIEM ingestion. Events are immutable, retained for 180 days, and cover security-relevant actions: user management, access control, credentials, scan triggers, configuration changes and data exports. Secrets and tokens are redacted and never appear in any response format. - name: Container Scanning description: >- Container image vulnerability scanning across AWS ECR, Azure ACR, and GCP GAR registries. List tracked containers with their latest scan, then fetch the full vulnerability findings of a scan — the same data shown on the Cloud Security → Container Scanning page. Authenticate with a CodeAnt API token (requires the `view_cloud_security: read` permission when token scoping is configured). - name: Security Hotlist description: >- The organization-wide security Hotlist: every SCA, SAST, secrets, IaC, cloud (CSPM) and AI-exploitation finding, deduplicated and priority-scored into one ranked list with live ticket, assignee and SLA state. Query it with filters, facets and cursor pagination, or export the full filtered list as an Excel workbook. Authenticate with a CodeAnt API token (requires the `view_code_security: read` permission when token scoping is configured). paths: /api/metrics/developer/teams/delete: post: tags: - Developer Metrics - Teams summary: Delete Team description: >- 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. operationId: deleteTeam requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DeleteTeamRequest' examples: github: summary: GitHub value: platform: github org: my-org team_id: 15884668-91e2-4def-9d20-b7cf4698117d gitlab: summary: GitLab value: platform: gitlab org: my-group team_id: 15884668-91e2-4def-9d20-b7cf4698117d bitbucket: summary: Bitbucket value: platform: bitbucket org: my-workspace team_id: 15884668-91e2-4def-9d20-b7cf4698117d azure_devops: summary: Azure DevOps value: platform: azure_devops org: my-org team_id: 15884668-91e2-4def-9d20-b7cf4698117d responses: '200': description: Team deleted content: application/json: schema: $ref: '#/components/schemas/DevMetricsStatusResponse' example: status: success message: Team deleted successfully '400': description: Bad request - missing or invalid parameters content: application/json: schema: $ref: '#/components/schemas/DevMetricsErrorResponse' example: error: 'Missing required parameters: platform, org' '401': description: Unauthorized - missing, invalid, or insufficient access token content: application/json: schema: $ref: '#/components/schemas/DevMetricsErrorResponse' examples: missing_token: summary: Missing Authorization header value: error: Missing Authorization header. Use 'Bearer ' invalid_token: summary: Invalid or insufficient token value: error: >- Access token invalid or does not have access to this organization '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/DevMetricsStatusResponse' example: status: error message: Team not found '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/DevMetricsStatusResponse' example: status: error message: Internal server error security: - BearerAuth: [] components: schemas: DeleteTeamRequest: allOf: - $ref: '#/components/schemas/DevMetricsBaseRequest' - type: object required: - team_id properties: team_id: type: string format: uuid description: ID of the team to delete hard_delete: type: boolean default: false description: >- If true, permanently removes the team. If false (default), soft-deletes by marking inactive. DevMetricsStatusResponse: type: object properties: status: type: string enum: - success - error message: type: string description: Human-readable status message DevMetricsErrorResponse: type: object properties: error: type: string description: Error message DevMetricsBaseRequest: type: object required: - platform - org properties: platform: type: string description: Version control platform enum: - github - gitlab - bitbucket - azure_devops - azuredevops example: github org: type: string description: Organization, workspace, or group name on the platform example: my-org github_base_url: type: string description: Base URL for GitHub (use for GitHub Enterprise Server) default: https://github.com example: https://github.com gitlab_base_url: type: string description: Base URL for GitLab (use for self-hosted GitLab instances) default: https://gitlab.com example: https://gitlab.com azure_devops_base_url: type: string description: Base URL for Azure DevOps (use for Azure DevOps Server) default: https://dev.azure.com example: https://dev.azure.com bitbucket_base_url: type: string description: Base URL for Bitbucket (use for Bitbucket Data Center/Server) default: https://api.bitbucket.org/2.0 example: https://api.bitbucket.org/2.0 securitySchemes: BearerAuth: type: http scheme: bearer description: >- CodeAnt API token (`cdt_...`), created on the Settings → API Tokens page. Pass via `Authorization: Bearer ` header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.