Restart an environment

Replaces every instance of the environment with new instances of the same settings. The write creates the next revision as a copy of the current one with a new restart nonce.

A restart keeps each pinned secret version. To roll out a new secret value, update the environment and name the binding again. A retried restart that already landed restarts again. If-Match applies as on the update.

The body is required and decoded strictly; send {} for the defaults. Requires the account_admin or developer role and Serve access.

POST

projects

{proj_id}

environments

{env}

restart

curl --request POST \
  --url https://api.reactor.inc/projects/{proj_id}/environments/{env}/restart \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "id": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d",
  "project_id": "0d3c6f4e-8a1b-4c2d-9e7f-1a2b3c4d5e6f",
  "name": "staging",
  "image": {
    "tag": null,
    "digest": "sha256:d138642b1cd5ea5bba6ed5655fa1d7dfced33889d149b094b2c32c32f09ed3da",
    "ref": null
  },
  "weights": null,
  "resources": {
    "accelerators": []
  },
  "extra_args": [],
  "node_selector": null,
  "instances": [
    {
      "count": 1
    }
  ],
  "variables": {},
  "revision": {
    "number": 2,
    "created_by": {
      "user_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
    },
    "created_at": "2026-10-12T10:00:00Z"
  },
  "public": false,
  "created_at": "2026-10-10T12:40:00Z",
  "deleted_at": null
}

{
  "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": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "etag_mismatch",
  "message": "environment staging is at revision 4, not 3"
}

{
  "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.

Headers

If-Match

string

The ETag of your last read, a revision number in quotes. If the environment's newest revision differs, the write is 412 etag_mismatch and nothing is written. A weak tag, a list, or * is 400.

Example:

"\"3\""

Path Parameters

proj_id

string<uuid>

required

The project's ID, a UUID. It is not the model's ID.

env

string

required

The environment's ID (a UUID) or its name, such as production. A name matches only a live environment; a deleted environment is reachable by its ID only.

Body

application/json

deployment_strategy

enum<string>

default:ROLLING

Available options:

ROLLING,

REPLACE_ALL

interrupt_sessions

boolean

default:false

End live sessions on replaced instances after the replacement. Needs REPLACE_ALL.

Response

The environment; revision names the new copy.

string<uuid>

required

The environment's ID. It is neither the project's nor the model's ID.

project_id

string<uuid>

required

name

string

required

image

object | null

required

The current image. For production, the deployed release's image. Null for another environment before its first revision.

Show child attributes

weights

object | null

required

The pinned weights. Null when none are pinned.

Show child attributes

resources

object

required

What each instance gets.

Show child attributes

extra_args

string[]

required

Extra arguments passed to the model container.

node_selector

string | null

required

Read-only.

instances

object[]

required

Show child attributes

revision

object | null

required

The current revision. Null before the first revision.

Show child attributes

public

boolean

required

When true, any authenticated caller can open sessions on production. It grants no read. Read-only for customers.

created_at

string<date-time>

required

deleted_at

string<date-time> | null

required

When the environment was deleted. A deleted environment takes no writes.

variables

object

Variables keyed by name. Names use letters, digits, _, -, and ., with no leading digit. Reserved names such as MODEL_NAME and any REACTOR_ name are refused.

Show child attributes

⌘I

curl --request POST \
  --url https://api.reactor.inc/projects/{proj_id}/environments/{env}/restart \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "id": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d",
  "project_id": "0d3c6f4e-8a1b-4c2d-9e7f-1a2b3c4d5e6f",
  "name": "staging",
  "image": {
    "tag": null,
    "digest": "sha256:d138642b1cd5ea5bba6ed5655fa1d7dfced33889d149b094b2c32c32f09ed3da",
    "ref": null
  },
  "weights": null,
  "resources": {
    "accelerators": []
  },
  "extra_args": [],
  "node_selector": null,
  "instances": [
    {
      "count": 1
    }
  ],
  "variables": {},
  "revision": {
    "number": 2,
    "created_by": {
      "user_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
    },
    "created_at": "2026-10-12T10:00:00Z"
  },
  "public": false,
  "created_at": "2026-10-10T12:40:00Z",
  "deleted_at": null
}

{
  "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": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "etag_mismatch",
  "message": "environment staging is at revision 4, not 3"
}

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

Get started

SDK Reference

CLI Reference

Platform API Reference

Endpoints

Restart an environment

Authorizations

Headers

Path Parameters

Body

Response