---
title: "Download a file from the network to the local node if it's not available locally. Note: Download is performed async. Call can return before download is completed."
method: POST
path: "/data/{cid}/network"
tags: ["Data"]
---

# Download a file from the network to the local node if it's not available locally. Note: Download is performed async. Call can return before download is completed.

`POST /data/{cid}/network`

## Path parameters

- `cid` string, required — Content Identifier as specified at https://github.com/multiformats/cid

## Response `200`

Manifest information for download that has been started.

- DataItem
  - `cid` string, required — Content Identifier as specified at https://github.com/multiformats/cid
  - `manifest` ManifestItem, required
    - `treeCid` string, required — Content Identifier as specified at https://github.com/multiformats/cid
    - `datasetSize` integer, required — Length of original content in bytes
    - `blockSize` integer, required — Size of blocks
    - `filename` string, nullable — The original name of the uploaded content (optional)
    - `mimetype` string, nullable — The original mimetype of the uploaded content (optional)

## Other responses

- `400` — Invalid CID is specified
- `404` — Failed to download dataset manifest
- `500` — Well it was bad-bad

## Changes

- **2026-01-16** `1cb7c01da4d4` — 1 breaking
  - removed the required property `manifest/protected` from the response with the `200` status
- **2025-04-02** `c45fb5a40b67` — 6 info
  - the response property `cid` became required for the status `200`
  - the response property `manifest` became required for the status `200`
  - the response property `manifest/blockSize` became required for the status `200`
  - the response property `manifest/datasetSize` became required for the status `200`
  - …2 more
- **2025-02-12** `92de50a3b676` — 1 warning
  - removed the optional property `manifest/uploadedAt` from the response with the `200` status
- **2024-11-15** `a7a2448e76f2` — 3 breaking, 2 warning, 2 info
  - the response property `manifest/filename` became nullable for the status `200`
  - the response property `manifest/mimetype` became nullable for the status `200`
  - the response property `manifest/uploadedAt` became nullable for the status `200`
  - removed the optional property `manifest/originalBytes` from the response with the `200` status
  - …3 more
- **2024-10-25** `d0fe80e2a0ba` — 3 info
  - added the optional property `manifest/filename` to the response with the `200` status
  - added the optional property `manifest/mimetype` to the response with the `200` status
  - added the optional property `manifest/uploadedAt` to the response with the `200` status

[Full history](https://skmtc.dev/logos-storage/apis/logos-storage-api/changes/data/:cid/network/post.md)

---

[API](https://skmtc.dev/logos-storage/apis/logos-storage-api.md) · [All operations](https://skmtc.dev/logos-storage/apis/logos-storage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/logos-storage/logos-storage-api/revisions/08d9f3fb83f3/schema)