Skip to main content
POST
Create a new environment version

Authorizations

Authorization
string
header
required

API key with the vk_ prefix. Create one from the dashboard.

Path Parameters

env_id
string
required

Environment ID

Body

application/json

The environment spec as submitted. Also the body of POST /v1/environments/{id}/versions.

harness
string | null

claude-code (the only harness today).

model
object

Where the harness sends model calls.

size
string | null

small | standard (default) | large.

egress
string | null

restricted (default) | audited_open | unrestricted (Enterprise).

egress_preset
string | null

The default egress rules: coding (default; GitHub, npm, PyPI, the Veri API, scoped secret hosts) | web_research (coding + GET/HEAD/ OPTIONS to any host) | locked_down (none).

allowed_hosts
string[]

Extra hosts a restricted session may reach with any method and path (shorthand for an egress_rules entry with only host).

egress_rules
object[]

Allow rules narrower than a host: methods and path prefixes. A rule naming a host replaces the preset's access to that host.

env
object

Plain environment variables for the harness. PATH, LD_*, GCONV_PATH, GLIBC_TUNABLES and the model wiring are reserved.

secrets
string[]

Secret names injected as environment variables named after them (or attached per host when the secret has a scope_host).

mcp_servers
object[]
skills
string[]

Skill names, optionally pinned: name (latest) or name@3.

permissions
object
idle_timeout_s
integer<int64> | null

Seconds without input before the session snapshots and pauses (60 .. 21600, default 900).

Response

The environment with the new version

object
string
required
id
string
required
name
string
required
latest_version
integer<int32>
required
created_by
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
version
object
required

The latest version unless ?version= asked for another.

description
string | null