Register a release
Registers a new release tag for a model you own, and deploys it unless deploy is
false. The tag must be a semver-style version such as v1.2.3-gabcdef0, unique per
model, and must not contain /.
A release cannot deploy until its container image is recorded with
PUT /models/{id}/releases/{release}/image. Register with deploy: false, push the image,
then deploy with PUT /models/{id}/releases. reactor model publish runs this sequence.
weights_ref pins the release’s weights to a Hugging Face commit
(hf://org/repo@<40-hex-sha>); those weights are read at session start, never uploaded.
With ?idempotent=true, registering a tag that exists but was never deployed returns
200 instead of 409.
Callable by an account_admin or developer of the owning account when model serving is
enabled for the account.
Authorizations
A Reactor API key (rk_...), sent as Authorization: Bearer rk_.... Keep it on a server.
Path Parameters
The model's ID (not its project ID). Find it with GET /models?name=your-org/your-model.
Query Parameters
When true, an existing release that was never deployed returns 200 instead of 409.
Body
A semver-style tag, unique per model, without /.
"v1.2.3-gabcdef0"
Deploy immediately. Use false until the image is recorded.
A Hugging Face reference pinned to a 40-character commit SHA.
"hf://your-org/your-weights@0123456789abcdef0123456789abcdef01234567"
Response
idempotent=true and the release already exists without having been deployed.