---
title: "Upload a storage file"
method: PUT
path: "/api/v1/storage/files/{path}"
tags: ["storage"]
---

# Upload a storage file

`PUT /api/v1/storage/files/{path}`

Creates or overwrites a file under an advertised storage root. Parent directories are created automatically after path sandbox validation. Omit `root` to use the default `appData` root.

## Path parameters

- `path` string, required

## Query parameters

- `root` string

## Request body

- FileUploadRequest — unresolved $ref

## Response `200`

Uploaded file metadata.

- FileUploadResponse — unresolved $ref

## Other responses

- `400` — Invalid or unsafe storage path or unavailable storage root.
- `500` — Internal server error.

---

[API](https://skmtc.dev/dotnet/apis/devflow-agent-protocol.md) · [All operations](https://skmtc.dev/dotnet/apis/devflow-agent-protocol/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dotnet/devflow-agent-protocol/revisions/31dec8eed3de/schema)