---
title: "Creates a new Request for storage"
method: POST
path: "/storage/request/{cid}"
tags: ["Marketplace"]
---

# Creates a new Request for storage

`POST /storage/request/{cid}`

## Path parameters

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

## Request body

- StorageRequestCreation
  - `duration` integer, required — The duration of the request in seconds
  - `pricePerBytePerSecond` string, required — The amount of tokens paid per byte per second per slot to hosts the client is willing to pay
  - `proofProbability` string, required — How often storage proofs are required as decimal string
  - `nodes` integer — Minimal number of nodes the content should be stored on
  - `tolerance` integer — Additional number of nodes on top of the `nodes` property that can be lost before pronouncing the content lost
  - `collateralPerByte` string, required — Number as decimal string that represents how much collateral per byte is asked from hosts that wants to fill a slots
  - `expiry` integer, required — Number that represents expiry threshold in seconds from when the Request is submitted. When the threshold is reached and the Request does not find requested amount of nodes to host the data, the Request is voided. The number of seconds can not be higher then the Request's duration itself.

## Response `200`

Returns the Request ID as decimal string

## Other responses

- `400` — Invalid or missing Request ID
- `404` — Request ID not found
- `422` — The storage request parameters are not valid
- `503` — Persistence is not enabled

## Changes

- **2025-04-02** `c45fb5a40b67` — 2 breaking, 2 warning, 2 info
  - the `duration` request property type changed from `string` to `integer`, and format from no format to `int64`
  - the `expiry` request property type changed from `string` to `integer`, and format from no format to `int64`
  - the `nodes` request property's min was set to `3.00`
  - the `tolerance` request property's min was set to `1.00`
  - …2 more
- **2025-03-24** `a7495e52e048` — 1 info
  - added the non-success response with the status `422`
- **2025-01-24** `03c5cc35cc9e` — 2 breaking, 2 warning
  - added the new required request property `collateralPerByte`
  - added the new required request property `pricePerBytePerSecond`
  - removed the request property `collateral`
  - removed the request property `reward`
- **2024-03-29** `f1941bd3be7f` — 2 breaking
  - the `nodes` request property type changed from `number` to `integer`
  - the `tolerance` request property type changed from `number` to `integer`
- **2024-03-26** `40df38b968da` — 1 info
  - added the media type `text/plain` for the response with the status `200`

[Full history](https://skmtc.dev/logos-storage/apis/logos-storage-api/changes/storage/request/:cid/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/c45fb5a40b67/schema)