Sign in
Environments

Create environment

Creates a server-owned environment definition in the environment catalog. REST environment requests only accept inline Dockerfile content; local Dockerfile paths are supported by workflow/settings files but rejected by this API.

post/api/v1/environments

Request body

idstring required
provider'local' | 'docker' | 'daytona' required

Desired environment provider.

labelsStringMap required
envobject required

Example request

{
  "id": "docker"
}

Response

Environment created

idstring required
revisionstring required

Stable revision used with If-Match for optimistic concurrency.

provider'local' | 'docker' | 'daytona' required

Desired environment provider.

labelsStringMap required
envobject required

Example response

{
  "id": "docker",
  "revision": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
}

Changes