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

# Offers storage for sale

`POST /sales/availability`

## Request body

- SalesAvailability
  - `totalSize` integer, required — Total size of availability's storage in bytes
  - `duration` integer, required — The duration of the request in seconds
  - `minPricePerBytePerSecond` string, required — Minimal price per byte per second paid (in amount of tokens) for the hosted request's slot for the request's duration as decimal string
  - `totalCollateral` string, required — Total collateral (in amount of tokens) that can be used for matching requests
  - `enabled` boolean — Enable the ability to receive sales on this availability.
  - `until` integer — Specifies the latest timestamp, after which the availability will no longer host any slots. If set to 0, there will be no restrictions.

## Response `201`

Created storage availability

- SalesAvailabilityREAD
  - `totalSize` integer, required — Total size of availability's storage in bytes
  - `duration` integer, required — The duration of the request in seconds
  - `minPricePerBytePerSecond` string, required — Minimal price per byte per second paid (in amount of tokens) for the hosted request's slot for the request's duration as decimal string
  - `totalCollateral` string, required — Total collateral (in amount of tokens) that can be used for matching requests
  - `enabled` boolean — Enable the ability to receive sales on this availability.
  - `until` integer — Specifies the latest timestamp, after which the availability will no longer host any slots. If set to 0, there will be no restrictions.
  - `id` string, required — 32bits identifier encoded in hex-decimal string.
  - `freeSize` integer — Unused size of availability's storage in bytes as decimal string
  - `totalRemainingCollateral` string, required — Total collateral effective (in amount of tokens) that can be used for matching requests

## Other responses

- `400` — Invalid data input
- `422` — Not enough node's storage quota available or the provided parameters did not pass validation
- `500` — Error reserving availability
- `503` — Persistence is not enabled

## Changes

- **2025-04-02** `c45fb5a40b67` — 8 breaking, 2 warning, 9 info
  - added the new required request property `duration`
  - added the new required request property `minPricePerBytePerSecond`
  - added the new required request property `totalCollateral`
  - added the new required request property `totalSize`
  - …15 more
- **2025-03-26** `3261a02e5377` — 4 info
  - added the new optional request property `allOf[#/components/schemas/SalesAvailability]/enabled`
  - added the new optional request property `allOf[#/components/schemas/SalesAvailability]/until`
  - added the optional property `allOf[#/components/schemas/SalesAvailability]/enabled` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/SalesAvailability]/until` to the response with the `201` status
- **2025-01-24** `03c5cc35cc9e` — 4 warning, 4 info
  - removed the request property `allOf[#/components/schemas/SalesAvailability]/maxCollateral`
  - removed the request property `allOf[#/components/schemas/SalesAvailability]/minPrice`
  - removed the optional property `allOf[#/components/schemas/SalesAvailability]/maxCollateral` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/SalesAvailability]/minPrice` from the response with the `201` status
  - …4 more
- …earlier changes not shown

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