---
title: "Physically remove an authorized file and revoke its links"
method: DELETE
path: "/v1/files/{fileId}"
tags: ["Files"]
---

# Physically remove an authorized file and revoke its links

`DELETE /v1/files/{fileId}`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/v1/files/{fileId}`
- Auth: none declared

Authenticated tenant and current Workbench mapping/clearance required. Gateway credentials delegate no independent privileges. No file contents are logged.

## Path parameters

- `fileId` string, required

## Query parameters

- `openWebuiOrgId` string
- `token` string

## Request body

- object
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Physically remove an authorized file and revoke its links

- object

## Other responses

- `401`: Authentication required
- `403`: Mapping, tenant, confidentiality or signed-link authorization denied
- `413`: Configured file/expanded archive budget exceeded
- `422`: Invalid file type, name or encoding

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)