--- title: "Purge a File" slug: "purgeafile" updated: 2026-04-15T05:15:53Z published: 2026-04-15T05:15:53Z canonical: "help.12dsynergy.com/purgeafile" --- > ## 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. # Purge a File This tutorial demonstrates how to purge a file by ID via the RESTful API. Purging a file means removing the file permanently. > [!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. Purging a File using the File ID This request is in the API documentation under Files, marked 'Purge a file (delete a file permanently)'. **Sample Request** ```SampleRequest curl --location 'http://synergy.myserver.com/api/v1/files/{file-id-here}/purge' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' ``` Below is a sample response when purging a file. **Sample Response** true