---
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` string, required — The duration of the request in seconds as decimal string
  - `reward` string, required — The maximum amount of tokens paid 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
  - `collateral` string, required — Number as decimal string that represents how much collateral is asked from hosts that wants to fill a slots
  - `expiry` string, required — Number as decimal string 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
- `503` — Persistence is not enabled

## Changes

- **2024-03-29** `f1941bd3be7f` — 2 breaking
  - the `nodes` request property type/format changed from `number`/`` to `integer`/``
  - the `tolerance` request property type/format changed from `number`/`` to `integer`/``
- **2024-03-26** `40df38b968da` — 1 info
  - added the media type `text/plain` for the response with the status `200`
- **2023-11-22** `53c8ab95bc8f` — 1 breaking
  - the request property `expiry` became required
- **2023-11-13** `60994a71e2e3` — 1 info
  - added the new optional request property `expiry`
- **2023-04-14** `0e176b61eaf1` — 1 breaking
  - added the new required request property `collateral`

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