---
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` number — Minimal number of nodes the content should be stored on
  - `tolerance` number — 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 — Number as decimal string that represents expiry time of the request (in unix timestamp)

## Response `200`

Returns the Request ID as decimal string

## Other responses

- `400` — Invalid or missing Request ID
- `404` — Request ID not found
- `503` — Purchasing is unavailable

## Changes

- **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`
- **2023-03-27** `f956dc43ab5c` — 1 breaking, 2 info
  - added the new required request property `proofProbability`
  - the `nodes` request property default value changed from `1 node` to `1`
  - the `tolerance` request property default value changed from `0 nodes` to `0`
- **2023-03-15** `dfe487dfc0e2` — 1 info
  - endpoint added

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