Skip to main content
POST
Add a repository to an 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

Query Parameters

org
string

Billing wallet for this request: an organization you belong to, by id (team_…) or by name as GET /orgs lists it (case-insensitive), or personal. Omitted, the account's active wallet applies (PATCH /orgs/active; personal until set). Two organizations sharing the name answer 409 ambiguous_org and need the id. Sandboxes and snapshots stay creator-private. On /environments routes, only this query parameter selects the organization's shared environments; the X-Boat-Org header and the active wallet do not apply there. Members read them, owners and admins change them.

Body

application/json
repositoryId
string
required

The repository databaseId from GET /repos.

baseBranch
string
default:main

Response

New version minted.

Result of a granular environment change. Every change mints a new immutable version holding just that delta; existing sandboxes stay pinned until upgraded.

success
boolean
required
versionId
string

Id of the newly minted environment version. This is a version id, not the environment's own id: the environment id you passed in the path is unchanged.

versionNumber
integer