Skip to main content
PATCH
Update a computer environment

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

projectId
string
required

ID of the hosted project that contains the server.

environmentId
string
required

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

Body

application/json

Edit an environment. Provide at least one of name or dockerfile; only the fields you pass change.

name
string
required

New display name; must be non-empty after trimming.

Minimum string length: 1
dockerfile
string

Replacement Dockerfile text.

Minimum string length: 1

Response

The updated environment.

A project's custom Computer image: a digest-pinned Dockerfile plus its latest build.

id
string
required
projectId
string
required
name
string
required
dockerfile
string
required
contentHash
string
required
sharing
enum<string>
required

user = a personal draft; project = shared with the whole project.

Available options:
user,
project
isOwner
boolean
required
currentBuild
object | null
required

One build of an environment's image.

createdAt
number
required
updatedAt
number
required