Environments

Show one environment

Changed on

Read one environment, including the revision you pass back as expectedRevision when writing to it.

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

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}
  • 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 environment.

idstring required
projectIdstring required
namestring required

Unique among the project's live (non-archived) environments.

descriptionstring
hostIdstring required

The host this environment runs against.

serverAttachmentIdstring

Present only when the environment pins a standalone server group; otherwise the host config's own servers apply.

modelIdstring

The environment's model override. ABSENT means the environment INHERITS the model pinned on its host — not that it has no model. Resolve the environment and read effectiveModelId to learn what will actually run. COMPUTED in responses: the selection's modelId when there is one, else the stored bare id. Accepted on writes as a shorthand: send a bare id and the platform converts it (a hosted id becomes a hosted selection, any other a LegacyModelSelection).

modelSelectionOrigin'backfill'

backfill when a conversion (a save of a bare id, or the old-data backfill) chose modelSelection rather than a person. Absent when a person chose it, and on rows with no selection.

pluginVersionIdsstring[]

Pinned plugin VERSION IDs. Narrow by design: the plugin must be installed and enabled, the version must be ready, at most one version per plugin may be pinned, and none of its skills may carry supporting files. Not a general-purpose plugin list.

sandboxImageIdstring

Sandbox-image pin: a project-shared image (see the images endpoints) that eval runs in this environment boot a fresh sandbox from. Absent when unpinned.

revisioninteger required

Optimistic-concurrency counter. Pass this back as expectedRevision on the next write; if it no longer matches, the write is rejected with 409 instead of overwriting a concurrent edit.

archivedboolean required

Archived environments cannot be edited or launched until restored.

archivedAtnumber

Unix epoch milliseconds. Present only when archived.

createdAtnumber required

Unix epoch milliseconds.

updatedAtnumber required

Unix epoch milliseconds.

Changes

  • 9826d734d268Revision changes
    • info

      added the optional property to the response with the status

    • info

      the response optional property became read-only for the status

    • info

      added to the response property allOf list for the response status

    • info

      removed from the response property allOf list for the response status

  • c9e609871357Revision changes
    • info

      added the optional property to the response with the status