--- title: "Delete a Task" slug: "deleteatask" updated: 2026-04-15T06:22:22Z published: 2026-04-15T06:22:22Z canonical: "help.12dsynergy.com/deleteatask" --- > ## 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 ' \ --header 'Content-Type: application/json' \ ``` Below is a sample response when deleting a task. **Sample Response** true