Deploy a release

Deploys a registered release of a model you own, for example to roll back or to activate a release registered with deploy: false. The CLI equivalent is reactor model deploy.

instances is the full desired instance plan, one entry per region. A region you omit from a non-empty plan is scaled to zero, and instances: [] scales every region to zero. Omitting instances leaves capacity unchanged. For a GPU model, the plan is checked against your account’s accelerator allocation in each region. Valid region names come from GET /clusters/regions; the plan may hold at most 1000 instances.

strategy is ROLLING (default; instances are replaced one at a time) or REPLACE_ALL (the whole old generation stops at once; faster, but a release that never becomes ready leaves the model with no capacity). Values are matched exactly. Neither strategy ends a running session early. immediate: true, legal only with REPLACE_ALL, also closes the model’s live sessions once the deploy is sent.

A release with no weights of its own reuses the weights of the most recent deployed release that has a complete bundle (weights_carried_from), or deploys without weights (weights_missing: true).

Callable by an account_admin or developer of the owning account when model serving is enabled for the account.

PUT

models

{id}

releases

curl --request PUT \
  --url https://api.reactor.inc/models/{id}/releases \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "release": "v1.2.3-gabcdef0",
  "instances": [
    {
      "region": "us-west",
      "count": 2
    },
    {
      "region": "us-east",
      "count": 1
    }
  ]
}
'

{
  "release": "v1.2.3-gabcdef0",
  "weights_carried_from": "v1.2.2-g1234567",
  "immediate": false,
  "revision": {
    "number": 3
  }
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "accelerator_quota_exceeded",
  "message": "deployment plan would commit 12 'NVIDIA_H100' accelerators in region 'us-east', but only 10 are allocated to this account. Lower the requested count or request a larger allocation"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

Authorizations

Authorization

string

header

required

A Reactor API key (rk_...), sent as Authorization: Bearer rk_.... Keep it on a server.

Path Parameters

string<uuid>

required

The model's ID (not its project ID). Find it with GET /models?name=your-org/your-model.

Body

application/json

release

string

The release to deploy. Required on PUT; optional on PATCH.

Example:

"v1.2.3-gabcdef0"

instances

object[]

The instance plan per region. On PUT it replaces the plan; on PATCH it merges. Omit to leave capacity unchanged.

Show child attributes

strategy

enum<string>

default:ROLLING

How the old release stops serving. Matched exactly.

Available options:

ROLLING,

REPLACE_ALL

immediate

boolean

default:false

Close the model's live sessions once the deploy is sent. Requires a release and REPLACE_ALL.

Response

The deploy was accepted.

release

string

required

The release now deployed.

immediate

boolean

required

Whether this deploy closes live sessions.

weights_carried_from

string

The release whose weights were reused because this release has none.

weights_missing

boolean

true when the release deployed with no weights available. Omitted when false.

revision

object

The production revision this deploy created. Omitted when nothing changed.

Show child attributes

⌘I

curl --request PUT \
  --url https://api.reactor.inc/models/{id}/releases \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "release": "v1.2.3-gabcdef0",
  "instances": [
    {
      "region": "us-west",
      "count": 2
    },
    {
      "region": "us-east",
      "count": 1
    }
  ]
}
'

{
  "release": "v1.2.3-gabcdef0",
  "weights_carried_from": "v1.2.2-g1234567",
  "immediate": false,
  "revision": {
    "number": 3
  }
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "accelerator_quota_exceeded",
  "message": "deployment plan would commit 12 'NVIDIA_H100' accelerators in region 'us-east', but only 10 are allocated to this account. Lower the requested count or request a larger allocation"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

Get started

SDK Reference

CLI Reference

Platform API Reference

Endpoints

Deploy a release

Authorizations

Path Parameters

Body

Response