Remove a planned task
What this does: Soft deletes a pipeline item, removing it from the pipeline view. The task itself is not deleted, only the planning/scheduling entry. This is useful when a task needs to be removed from the weekly plan but may be rescheduled later.
How it works:
- Performs a soft delete (marks as deleted, doesn’t permanently remove)
- The task remains in the system and can be re-planned later
- The item disappears from the pipeline view immediately
- If the week is already active, the task will also be removed from the team member’s stack
Required Permission: User must have either Pipeline.canPlanAll OR Pipeline.canPlanOwnTeams permission
Permission-based Deletion:
- Users with Pipeline.canPlanAll can delete any pipeline item in the workspace
- Users with Pipeline.canPlanOwnTeams can only delete items assigned to themselves or users in their teams
Use cases:
- Remove tasks that are no longer needed in the weekly plan
- Clear planning when tasks are cancelled or postponed
- Adjust capacity by removing lower-priority items
DELETE
/tasks/pipeline/items/{id}Authorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:writeor
AuthorizationBearer token (JWT) · headerrequiredPath parameters
idstringrequiredResponses
200Pipeline item successfully deleted
successboolean401Unauthorized - Invalid or missing authentication token
403Missing required permissions or not allowed to delete this item
404Pipeline item not found
Request
curl -X DELETE "https://leadtime.app/api/public/tasks/pipeline/items/string" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"const response = await fetch("https://leadtime.app/api/public/tasks/pipeline/items/string", {
method: "DELETE",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.delete(
"https://leadtime.app/api/public/tasks/pipeline/items/string",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
{
"success": true
}Unauthorized - Invalid or missing authentication token
Missing required permissions or not allowed to delete this item
Pipeline item not found