---
title: "Delete a File"
slug: "deleteafile"
updated: 2026-04-15T05:18:18Z
published: 2026-04-15T05:18:18Z
---

> ## 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 File

This tutorial demonstrates how to delete a file by File ID via the RESTful API.

> [!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://synergy.myserver.com/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. Deleting a File using the File ID

This request is in the API documentation under Files marked 'Delete a file (mark file as deleted)'.

**Sample Request**

```SampleRequest
curl --location 'http://{your-server-here}/api/v1/files/delete' \

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

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

--data '{

  "id": {

    "_id": 170158, 

    "_server_id": 1,

    "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

    "IDString": "170158_1"

  },

  "description": "string"

}'
```

Below is a sample response when deleting a file.

**Sample Response**

true