Delete task

Soft-delete a task by marking it as skipped.

DELETE/api/task-queue/{task_id}

HTTP referenceScope tasks:writeUpdated April 25, 2026

This page documents the canonical HTTP contract for this endpoint.

Name	Type	Description
task_idrequired	string	Task ID.

Name	Type	Description
actorUserId	string	Optional actor override.

Status	Meaning
400	Invalid task ID format.
401	Invalid API key or missing auth.
403	Missing tasks:write scope.
404	Task not found.

bash

curl -X DELETE "https://app.autotouch.ai/api/task-queue/67c4d064b4dd8f2d4999f611" \
    -H "Authorization: Bearer stk_your_key_id.your_secret"

json

{
    "success": true,
    "message": "Task deleted (marked as skipped)"
  }