models

Set Model Head

Changed on

Point the model's active checkpoint (head) at one of its checkpoint nodes.

put/v2/models/{model_id}/head

Request

  • Base URL
    https://api.hud.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.hud.ai/v2/models/{model_id}/head
  • Auth
    none declared

Path parameters

model_idstring uuid required

Request body

checkpoint_idstring uuid required

Response

Successful Response

idstring uuid required
model_namestring required
namestring nullable
routesstring[]
is_betaboolean
hiddenboolean
is_trainableboolean
publicboolean
checkpoint_countinteger nullable
inference_countinteger nullable

Lifetime platform-wide inference-call count. Null for signed-out callers.

fork_of_model_idstring uuid nullable
fork_of_model_namestring nullable
context_windowinteger nullable
sdk_agent_typestring required
input_cost_per_tokennumber nullable
output_cost_per_tokennumber nullable
pricing_configobject
request_defaultsobject
metadataobject
created_atstring date-time required
released_atstring date-time nullable

Vendor-published release time. Null until an admin sets it; not catalog insert time.

deprecated_atstring date-time nullable

Vendor retirement time. Null = not deprecated. A future value announces the date; once it passes, the gateway rejects requests for the model.

deprecation_messagestring nullable

Operator-set deprecation notice shown in the UI and returned on rejected requests.

can_editboolean

Changes