---
title: "Upload files to flow workspace"
method: POST
path: "/flows/{flowID}/files/"
tags: ["FlowFiles"]
---

# Upload files to flow workspace

`POST /flows/{flowID}/files/`

## Path parameters

- `flowID` integer, required

## Response `200`

flow files uploaded successful

- 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 files request data
- `403` — uploading flow files not permitted
- `404` — flow not found
- `409` — flow file already exists
- `500` — internal error on uploading flow files

## Changes

- **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/post.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)