---
title: "Update host check"
method: PUT
path: "/bus/host/{hostkey}/check"
tags: ["bus"]
---

# Update host check

`PUT /bus/host/{hostkey}/check`

Updates host checks for a specific host. Host checks include gouging checks, but also other checks that score the host in relation to other hosts

## Path parameters

- `hostkey` string, required — A ed25519 public key

## Request body

- HostChecks
  - `gougingBreakdown` HostGougingBreakdown
    - `downloadErr` string — Error message related to download gouging checks.
    - `gougingErr` string — Error message related to general gouging checks.
    - `pruneErr` string — Error message related to pruning checks.
    - `uploadErr` string — Error message related to upload gouging checks.
  - `scoreBreakdown` HostScoreBreakdown
    - `age` number, float — Score contribution based on the host's age.
    - `collateral` number, float — Score contribution based on the host's collateral amount.
    - `interactions` number, float — Score contribution based on successful interactions.
    - `storageRemaining` number, float — Score contribution based on remaining storage capacity.
    - `uptime` number, float — Score contribution based on host uptime.
    - `version` number, float — Score contribution based on the host's software version.
    - `prices` number, float — Score contribution based on pricing metrics.
  - `usabilityBreakdown` HostUsabilityBreakdown
    - `blocked` boolean — Indicates if the host is blocked.
    - `offline` boolean — Indicates if the host is offline.
    - `lowMaxDuration` boolean — Indicates if the host has a low maximum contract duration.
    - `lowScore` boolean — Indicates if the host has a low score.
    - `redundantIP` boolean — Indicates if the host's IP address is redundant.
    - `gouging` boolean — Indicates if the host is gouging prices.
    - `notAcceptingContracts` boolean — Indicates if the host is not accepting new contracts.
    - `notAnnounced` boolean — Indicates if the host has not been announced on the network.
    - `notCompletingScan` boolean — Indicates if the host is failing to complete scans.

## Response `200`

Host check updated successfully

## Other responses

- `400` — Malformed request
- `500` — Internal server error

---

[API](https://skmtc.net/siafoundation/apis/renterd-api.md) · [All operations](https://skmtc.net/siafoundation/apis/renterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/siafoundation/renterd-api/versions/184a3d5207da/schema)