---
title: "Deploy Rebalance Status"
method: GET
path: "/deploy/{deploy_id}/rebalance"
tags: ["Dedicated Models"]
---

# Deploy Rebalance Status

`GET /deploy/{deploy_id}/rebalance`

Status of GPU pool rebalances touching this deployment. A just-started
rebalance can take a moment to appear. A finished or cancelled rebalance
leaves both deployments' min/max instances fixed at the final counts; edit
them to resume autoscaling.

## Path parameters

- `deploy_id` string, required

## Headers

- `xi-api-key` string, nullable
- `x-api-key` string, nullable

## Response `200`

Successful Response

- RebalanceStatusOut
  - `active` RebalanceStatus
    - `replace_id` string, required — Id of the rebalance.
    - `direction` 'outgoing' | 'incoming', required — Whether this deployment is the source or the target.
    - `status` string, required — Rebalance status.
    - `placed` integer, required — Target instances delivered so far.
    - `count` integer, required — Target instances requested.
    - `source_deploy_id` string — Deploy Id of the source; empty if not yours.
    - `target_deploy_id` string — Deploy Id of the target; empty if not yours.
    - `source_model_name` string — Model name of the source; empty if not yours.
    - `target_model_name` string — Model name of the target; empty if not yours.
    - `error` string — Failure reason, if any.
    - `created_at` string, nullable, required — When the rebalance was requested.
    - `finished_at` string, nullable — When the rebalance finished.
  - `recent` RebalanceStatus[] — Finished rebalances, newest first.
    - `replace_id` string, required — Id of the rebalance.
    - `direction` 'outgoing' | 'incoming', required — Whether this deployment is the source or the target.
    - `status` string, required — Rebalance status.
    - `placed` integer, required — Target instances delivered so far.
    - `count` integer, required — Target instances requested.
    - `source_deploy_id` string — Deploy Id of the source; empty if not yours.
    - `target_deploy_id` string — Deploy Id of the target; empty if not yours.
    - `source_model_name` string — Model name of the source; empty if not yours.
    - `target_model_name` string — Model name of the target; empty if not yours.
    - `error` string — Failure reason, if any.
    - `created_at` string, nullable, required — When the rebalance was requested.
    - `finished_at` string, nullable — When the rebalance finished.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Validation Error

---

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