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
200
Pipeline item successfully deleted
successboolean401
Unauthorized - Invalid or missing authentication token
403
Missing required permissions or not allowed to delete this item
404
Pipeline item not found