---
search:
  tags:
    - teams
    - DELETE
seo:
  description: >-
    Soft deletes a team. The team will be marked as deleted but not permanently…
    Reference for the DELETE /teams/{id} endpoint in the Leadtime Public API
    API.
sidebar:
  badge: DELETE
  label: Delete a team
title: Delete a team
type: openapi-operation
---
Soft deletes a team. The team will be marked as deleted but not permanently removed from the database.

**What happens when a team is deleted:**
- The team is marked as deleted (soft delete)
- The team no longer appears in team lists
- Project assignments to this team are removed
- Historical data and associations are preserved
- The team cannot be restored through the API

**Important considerations:**
- Verify the team exists before deletion (endpoint returns 404 if not found)
- Consider removing team members or project assignments first if needed
- Deleted teams do not appear in GET requests
- This operation cannot be undone through the API

**What is returned:**
- Success confirmation

**Note:** Returns 404 if the team does not exist or has already been deleted. This endpoint requires the Teams.delete permission.

<Operation source="api-reference" id="teamscontroller-deleteteam" />