v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-035471202.8 KB

Environments

Preview what an environment resolves to

Resolve an environment to the exact execution inputs a run would use right now: the host's current config, the closed server set (including servers contributed by pinned plugin versions), and the resolved plugin versions. Returns 409 when the environment cannot currently produce a runnable configuration — for example a pinned plugin was disabled or deleted; details.code carries the specific reason (ENV_PLUGIN_UNAVAILABLE, ENV_NO_SERVERS, ENV_HOST_MISSING, …).

get/projects/{projectId}/environments/{environmentId}/resolve

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

environmentIdstring required

Project environment ID, as returned by the project's environment list.

Response

The resolved execution inputs.

hostIdstring required

hostNamestring required

hostConfigIdstring required

The host's config at resolve time — hosts rotate configs live, so this can change without the environment's revision changing.

serverAttachmentIdstring

sandboxImageIdstring

The environment's sandbox-image pin, when set.

selectedServerIdsstring[] required

The closed non-plugin server set.

effectiveServerIdsstring[] required

selectedServerIds plus the servers contributed by pinned plugin versions — the set a run actually connects. Identical to selectedServerIds when no plugins are pinned.