Skip to main content

signaloid-cli tasks delete

Delete a task.

Synopsis​

signaloid-cli tasks delete --task-id <id>

Options​

OptionRequiredDescription
--task-id <id>YesTask ID to delete

Description​

Permanently deletes a task and all its associated data, including outputs. This action cannot be undone.

Examples​

signaloid-cli tasks delete --task-id tsk_cbcfdc6736e84fd79b613f7793e653ce

Output:

{
  "TaskID": "tsk_cbcfdc6736e84fd79b613f7793e653ce",
  "deleted": true
}

Bulk deletion example:

# Delete all tasks older than 30 days
# `date -d` only available in Linux
CUTOFF=$(date -d '30 days ago' -u +"%Y-%m-%dT%H:%M:%SZ")

signaloid-cli tasks list --to $CUTOFF | jq -r '.Tasks[].TaskID' | \
while read TASK_ID; do
  echo "Deleting task: $TASK_ID"
  signaloid-cli tasks delete --task-id $TASK_ID
done

Notes​

  • This action is permanent and cannot be undone
  • All task data including outputs will be deleted
  • Running tasks should be cancelled before deletion
  • The command is idempotent - deleting an already deleted task will succeed

Troubleshooting​

Deleting Running Tasks​

Problem: You want to delete a task that is still running.

Solution: Cancel the task first with signaloid-cli tasks cancel --task-id $TASK_ID, then delete it. Alternatively, some implementations may automatically cancel running tasks when deleted.

See Also​

Last updated on