---
title: "Delete Call Flow Knowledge File"
api: "DELETE /v1/api/call-flows/knowledge-base/{fileKey}"
description: "Delete a stored call flow knowledge file by its storage key."
lastUpdated: "2026-11-04"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://trillet-ai.jamdesk.app/llms.txt). Append `.md` to any page URL for its markdown version.

<Note>
  This endpoint does not touch any call flow. To stop a flow using a file, remove it from the flow's `settings.knowledgeBaseFiles` with [Update Call Flow](https://trillet-ai.jamdesk.app/v1/api-reference/endpoints/flows/call-flows/update).
</Note>

<Warning>
  Known issue: this call can return `200` without removing the stored file. A fix is in progress; until then, don't rely on it to remove a file's contents.
</Warning>

### Headers

<ParamField header="x-workspace-id" type="string" required>
  Workspace identifier for the API.
</ParamField>

### Path Parameters

<ParamField path="fileKey" type="string" required>
  The storage key of the file. Keys contain `/`, so URL-encode the whole key (`/` becomes `%2F`). Only keys under your own workspace are accepted. The path does not include a call flow ID.
</ParamField>

### Response Fields

`200 OK` with `{ "success": true, "message": "File deleted successfully", "fileKey": "...", "result": true }`.

### Errors

| Status | Body | When |
| --- | --- | --- |
| `404` | `{"message": "File not found"}` | The key does not belong to this workspace |
| `500` | `{"message": "..."}` | The storage request failed |


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://trillet-ai.jamdesk.app/api-specs.zip
