---
title: "Changes to Search hosts using filters"
method: POST
path: "/bus/hosts"
---

# Changes to Search hosts using filters

`POST /bus/hosts`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 50 revisions.

- **2025-07-03** `472331be123c` — 2 warning
- **2025-03-13** `c878f2715ffd` — 10 breaking, 10 info
- **2024-12-18** `922f156353c9` — 1 breaking, 1 info
- **2024-12-17** `acbb46c060cb` — 1 info
- **2024-12-09** `f062c35d8f47` — 1 breaking

## Changes

- **2025-07-03** `472331be123c` — 2 warning
  - removed the optional property `items/priceTable` from the response with the `200` status
  - removed the optional property `items/settings` from the response with the `200` status
- **2025-03-13** `c878f2715ffd` — 10 breaking, 10 info
  - the `items/v2Settings/prices/collateral` response property's maxLength was unset from `39` for the response status `200`
  - the `items/v2Settings/prices/contractPrice` response property's maxLength was unset from `39` for the response status `200`
  - the `items/v2Settings/prices/egressPrice` response property's maxLength was unset from `39` for the response status `200`
  - the `items/v2Settings/prices/ingressPrice` response property's maxLength was unset from `39` for the response status `200`
  - the `items/v2Settings/prices/storagePrice` response property's maxLength was unset from `39` for the response status `200`
  - the `items/v2Settings/prices/collateral` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `items/v2Settings/prices/contractPrice` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `items/v2Settings/prices/egressPrice` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `items/v2Settings/prices/ingressPrice` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `items/v2Settings/prices/storagePrice` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - added `#/components/schemas/Currency, subschema #2` to the `items/v2Settings/prices/collateral` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Currency, subschema #2` to the `items/v2Settings/prices/contractPrice` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Currency, subschema #2` to the `items/v2Settings/prices/egressPrice` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Currency, subschema #2` to the `items/v2Settings/prices/ingressPrice` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Currency, subschema #2` to the `items/v2Settings/prices/storagePrice` response property `allOf` list for the response status `200`
  - the `items/v2Settings/prices/collateral` response's property pattern `^\d+$` was removed for the status `200`
  - the `items/v2Settings/prices/contractPrice` response's property pattern `^\d+$` was removed for the status `200`
  - the `items/v2Settings/prices/egressPrice` response's property pattern `^\d+$` was removed for the status `200`
  - the `items/v2Settings/prices/ingressPrice` response's property pattern `^\d+$` was removed for the status `200`
  - the `items/v2Settings/prices/storagePrice` response's property pattern `^\d+$` was removed for the status `200`
- **2024-12-18** `922f156353c9` — 1 breaking, 1 info
  - removed the media type `text/plain` for the response with the status `500`
  - api tag `bus` added
- **2024-12-17** `acbb46c060cb` — 1 info
  - endpoint added
- **2024-12-09** `f062c35d8f47` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/siafoundation/apis/renterd-api/docs/bus/hosts/post.md) · [API](https://skmtc.dev/siafoundation/apis/renterd-api.md) · [Page](https://skmtc.dev/siafoundation/apis/renterd-api/changes/bus/hosts/post)