Hanzo AI
OpenapiEngine

Replace replicas

Saves capacity, weight and preferred agent roles in the native router's pool file and applies them without dropping running streams or pins.

PUT /v1/engine/replicas

Addresshttps://api.hanzo.ai/v1/engine/replicas
MethodPUT
OperationengineUpdateReplica
AuthAuthorization: Bearer $HANZO_API_KEY

Saves capacity, weight and preferred agent roles in the native router's pool file and applies them without dropping running streams or pins. Only platform SuperAdmins can retune shared workers. The Rust runtime owns validation, durable storage and activation; cloud only carries the operation.

Request

5 fields, body application/json (required).

FieldInTypeRequiredDescription
capacitybodyinteger (int64)
idbodystring
modelbodystring
rolesbodystring[]
weightbodyinteger (int64)

Response

StatusBodyMeaning
200objectok
defaultproblem-detailsrefused

200 body — 10 fields.

FieldInTypeAlwaysDescription
*bodyengine.engineReplica[]
*[].capacitybodyinteger (int64)
*[].healthybodyboolean
*[].idbodystring
*[].inflightbodyinteger (int64)
*[].rolesbodystring[]
*[].ttft_ewma_msbodynumber (double)
*[].upstream_modelbodystring
*[].urlbodystring
*[].weightbodyinteger (int64)

Failure carries the platform error shape — see Errors.

Examples

hanzo engine replicas replace

Engine API · All Hanzo APIs · Interactive reference

How is this guide?

On this page