Skip to content
Leadtime
English
Esc
navigateopen⌘Jpreview

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 · headerrequired
Scopes:api:write
or
AuthorizationBearer token (JWT) · headerrequired
Path parameters
idstringrequired
Responses
200Team successfully deleted
successbooleanrequired
Operation 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"
Response
{
  "success": true
}