---
title: "Offers storage for sale"
method: POST
path: "/sales/availability"
tags: ["Marketplace"]
---

# Offers storage for sale

`POST /sales/availability`

## Request body

- SalesAvailabilityCREATE
  - `id` string — 32bits identifier encoded in hex-decimal string.
  - `totalSize` string, required — Total size of availability's storage in bytes as decimal string
  - `duration` string, required — The duration of the request in seconds as decimal string
  - `minPrice` string, required — Minimum price to be paid (in amount of tokens) as decimal string
  - `maxCollateral` string, required — Maximum collateral user is willing to pay per filled Slot (in amount of tokens) as decimal string

## Response `201`

Created storage availability

- SalesAvailabilityREAD
  - `id` string — 32bits identifier encoded in hex-decimal string.
  - `totalSize` string — Total size of availability's storage in bytes as decimal string
  - `duration` string — The duration of the request in seconds as decimal string
  - `minPrice` string — Minimum price to be paid (in amount of tokens) as decimal string
  - `maxCollateral` string — Maximum collateral user is willing to pay per filled Slot (in amount of tokens) as decimal string
  - `freeSize` string — Unused size of availability's storage in bytes as decimal string

## Other responses

- `400` — Invalid data input
- `422` — Not enough node's storage quota available
- `500` — Error reserving availability
- `503` — Sales are unavailable

## Changes

- **2024-03-21** `64a4e4f07d65` — 3 breaking, 5 warning, 3 info
  - added `#/components/schemas/SalesAvailability, subschema #2` to the request body `allOf` list
  - the request's body type changed from `object` to no type
  - removed the success response with the status `200`
  - removed the request property `duration`
  - …7 more
- **2023-04-14** `0e176b61eaf1` — 2 info
  - added the new optional request property `maxCollateral`
  - added the optional property `maxCollateral` to the response with the `200` status
- **2023-04-04** `ec53b2d31611` — 1 info
  - added the non-success response with the status `500`
- **2023-03-15** `dfe487dfc0e2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/logos-storage/apis/logos-storage-api/changes/sales/availability/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/64a4e4f07d65/schema)