Skip to main content
PUT
Update a sandbox environment

Authorizations

Authorization
string
header
required

Boat bearer token in the form boat_.... Service API keys authenticate sandbox operations.

Path Parameters

environmentId
string<uuid>
required

Environment id returned by GET /environments.

Body

application/json

Rename, set-default, and/or edit flags and contents. Any flag or content change mints a new immutable version; existing sandboxes are not touched until you call upgrade.

name
string

New environment name.

isDefault
boolean

Set to true to make this the default environment (clears the flag on the previous default).

safeForThirdParties
boolean
passGithub
boolean
passSecrets
boolean
passSandboxCredentials
boolean
passAgentsCredentials
boolean
envContents
string

Full .env-style content for the new version.

secretFiles
object[]
repositories
object[]

Full replacement of the version's repository selection. Each item selects one repository by its internal databaseId (from GET /repos).

Response

Updated environment.

success
boolean
required
environment
object | null

A named sandbox environment. All flags/contents reflect the latest version.