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
200Team successfully deleted
successbooleanrequiredOperation success flag
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
Request
curl -X DELETE "https://leadtime.app/api/public/teams/string" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"const response = await fetch("https://leadtime.app/api/public/teams/string", {
method: "DELETE",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.delete(
"https://leadtime.app/api/public/teams/string",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
{
"success": true
}Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions