---
title: "Delete flow files or directories by cached paths"
method: DELETE
path: "/flows/{flowID}/files/"
tags: ["FlowFiles"]
---

# Delete flow files or directories by cached paths

`DELETE /flows/{flowID}/files/`

## Path parameters

- `flowID` integer, required

## Query parameters

- `path` string
- `paths[]` string[]

## Response `200`

flow files deleted successfully

- object
  - `data` object
    - `files` ModelsFlowFile[]
      - `id` string
      - `is_dir` boolean
      - `modified_at` string
      - `name` string
      - `path` string — relative: "uploads/<x>" or resources/<x> or container/<x>"
      - `size` integer
    - `total` integer
  - `status` string

## Other responses

- `400` — invalid flow file request data
- `403` — deleting flow file not permitted
- `404` — flow file not found
- `500` — internal error on deleting flow file

## Changes

- **2026-05-04** `9f56c76dac04` — 2 info
  - added the new optional `query` request parameter `paths[]`
  - the `query` request parameter `path` became optional
- **2026-04-27** `a4b735edad4f` — 1 info
  - endpoint added
- **2026-03-26** `fe95938acc20` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api/changes/flows/:flowID/files/delete.md)

---

[API](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api.md) · [All operations](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vxcontrol/pentagi-swagger-api/revisions/7c1cbf7abaa1/schema)