Delete a task - Plain Docs

Deleting a task soft-deletes it. It is removed from the active task list but remains queryable by ID with isDeleted: true.

For TypeScript, the GraphQL SDK gives you a fully typed client for these operations.

This operation requires the following permissions:

task:delete

Mutation

mutation deleteTask($input: DeleteTaskInput!) {
  deleteTask(input: $input) {
    task {
      id
      isDeleted
    }
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}

Variables

{
  "input": {
    "taskId": "ta_01HXXXXXXXXXXXXXXXXXXXXXXX"
  }
}