---
title: "Delete a Task"
slug: "deleteatask"
updated: 2026-04-15T06:22:22Z
published: 2026-04-15T06:22:22Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.12dsynergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a Task

This tutorial demonstrates how to delete a task via the RESTful API.

The commands are provided in curl and can be run from the command prompt when the 12d Synergy Server is running (or in a batch script).

> [!NOTE]
> Additional API documentation
> 
> To get a list of most of the API requests available, with the 12d Synergy server running, browse [http://synergy.myserver.com/api-docs/ui/index](http://localhost:8080/api-docs/ui/index).
> 
> (Replace [synergy.myserver.com](http://synergy.myserver.com/) with the external server address and update the port numbers if necessary.)

### 1.1. Getting the Personal Access Token to access API

The tutorial for getting the PAT is here: [Generate PAT in Web client](/v1/docs/webclientgenerateapersonalaccesstokenpatinwebclientdoc).

### 1.2. Get the Task ID from the List of Tasks

To get the task type ID, you can follow the steps here: [Get Task Types](/v1/docs/gettasktypesdoc).

Getting the Task ID can be found by following the instructions here: [Search Task](/v1/docs/searchtaskdoc) or [Get Task for a Job](/v1/docs/gettaskforajobdoc).

### 1.3. Deleting the Task

This request is available in the API Documentation under Tasks,****marked 'Delete a task'.

Once you have the value of task_id, include it as a parameter.

This request should also include a description in the URL.

**Sample Request**

```SampleRequest
curl --location 'http://localhost:8080/api/v1/tasks/{task-id-here}/{description-here}' \

--header 'Authorization: Bearer <your-token-here>' \

--header 'Content-Type: application/json' \
```

Below is a sample response when deleting a task.

**Sample Response**

true