Skip to main content
POST
Create an environment

Authorizations

Authorization
string
header
required

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

Path Parameters

proj_id
string<uuid>
required

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

Body

application/json
name
string
required

1 to 32 lowercase letters, digits, or hyphens, starting with a letter.

Pattern: ^[a-z][a-z0-9-]{0,31}$

Response

The environment was created. Location names its path.

id
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.

weights
object | null
required

The pinned weights. Null when none are pinned.

resources
object
required

What each instance gets.

extra_args
string[]
required

Extra arguments passed to the model container.

node_selector
string | null
required

Read-only.

instances
object[]
required
revision
object | null
required

The current revision. Null before the first revision.

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.