Delete a team
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.
DELETE
/teams/{id}Authorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:writeor
AuthorizationBearer token (JWT) · headerrequiredPath parameters
idstringrequiredResponses
200
Team successfully deleted
successbooleanrequiredOperation success flag
401
Unauthorized - Invalid or missing authentication token
403
Forbidden - Insufficient API scopes or permissions