Delete a task that has not started, or one that is paused, completed or needs attention

Deletes the task and all of its items - only in draft/ready/paused/completed/needs_attention status, WITHOUT an in_progress item. revision is read from ?revision= OR a JSON body {"revision": ...} (the query parameter wins).

delete/v1/tasks/{id}

Request

  • Base URL: https://volai.cz
  • URL: https://volai.cz/v1/tasks/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Query parameters

revisioninteger

Expected current revision (optimistic concurrency). Alternatively send { "revision": ... } as a JSON request body.

Request body

revisioninteger required

Current task revision from GET /v1/tasks/{id}. On revision_conflict reload and review the new state before retrying. Reconciliation accepts omission; other task changes require the current revision.

Response

Deleted

deletedtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.