---
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 — Content Identifier as specified at https://github.com/multiformats/cid
  - `manifest` ManifestItem
    - `treeCid` string — Content Identifier as specified at https://github.com/multiformats/cid
    - `datasetSize` integer — Length of original content in bytes
    - `blockSize` integer — Size of blocks
    - `protected` boolean — Indicates if content is protected by erasure-coding
    - `filename` string, nullable — The original name of the uploaded content (optional)
    - `mimetype` string, nullable — The original mimetype of the uploaded content (optional)
    - `uploadedAt` integer, nullable — The UTC upload timestamp in seconds

## Other responses

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

## Changes

- **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
- **2024-10-17** `0f24d6801026` — 1 info
  - endpoint added
- **2023-03-15** `dfe487dfc0e2` — 1 breaking
  - api path removed without deprecation

[Change 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/a7a2448e76f2/schema)