---
title: "Open Folder Delivery"
method: POST
path: "/api/v1/files/upload/{token}/delivery"
tags: ["files"]
---

# Open Folder Delivery

`POST /api/v1/files/upload/{token}/delivery`

Declare (or resume) a folder delivery. The link is NOT consumed here.

## Path parameters

- `token` string, required

## Query parameters

- `delivery_id` string, uuid, nullable

## Request body

- DeliveryOpenRequest
  - `files` DeliveryFile[], required
    - `relative_path` string, required
    - `size_bytes` integer, required

## Response `200`

Successful Response

- DeliveryOpenResponse
  - `session_id` string, required
  - `files` DeliveryFile[]
    - `relative_path` string, required
    - `size_bytes` integer, required
  - `already_uploaded` string[]
  - `resumed` boolean, required
  - `shards` integer
  - `shard_size` integer
  - `total_files` integer
  - `total_bytes` integer
  - `already_uploaded_shards` integer[]

## Other responses

- `422` — Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-09-22** `156e22711796` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netter/apis/dmi-backend/changes/api/v1/files/upload/:token/delivery/post.md)

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) · [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/netter/apis/dmi-backend/revisions/77d4fd215b57?raw)