---
title: "Rebalance printers across hosts"
method: POST
path: "/v1/hosts/rebalance"
tags: ["Hosts"]
---

# Rebalance printers across hosts

`POST /v1/hosts/rebalance`

Compute load imbalances across hive-link nodes and move printers to balance load. Accepts API key auth (org derived from key) or Bearer JWT auth (organizationId required in body, membership verified).

## Request body

- object
  - `organizationId` string

## Response `200`

Default Response

- object
  - `ok` boolean
  - `plan` object
    - `moves` object[]
    - `reason` string
  - `result` object
    - `executed` number
    - `succeeded` number
    - `failed` number
    - `moves` object[]

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.net/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/revisions/64e0f1284c6f/schema)