Environments

Preview what an environment resolves to

Changed on

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

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve
  • Auth
    HTTP bearer

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.

modelIdstring

The environment's stored override, when it sets one.

effectiveModelIdstring

The model this environment WILL RUN — the override if it has one, else the host config's. Always present on a successful resolve: an environment with no model anywhere cannot be resolved for launch and fails with 409 details.reason: "environment_model_required".

modelSource'environment' | 'host'

Which of the two supplied effectiveModelId.

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.

Changes

  • 552bccab3295Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 968bce2f5a58Revision changes
    • info

      added the optional property to the response with the status