// Tenants

Change a tenant's environments for a project

Replace the environments a tenant can be deployed to for one connected project.

PUT/api/tenant/project

Description

Replaces the environments a tenant can be deployed to for a project it is already connected to.

Parameters

Name	In	Type	Required	Description
`tenantId`	body	string	yes	ID of the tenant.
`projectId`	body	string	yes	ID of a project the tenant is connected to.
`environmentIds`	body	array<string>	no	The complete set of environment IDs. Leave out or send `[]` for none.

Errors

Status	Meaning
`400`	Invalid `tenantId` or `projectId`, an environment that is not in this workspace, or the tenant is not connected to the project.
`401`	Missing or invalid Basic auth credentials, or the service account lacks permission to manage tenants in this workspace.

Request

PUT /api/tenant/project HTTP/1.1
Authorization: Basic <base64(serviceAccountId:apiKey)>
Content-Type: application/json

{
  "tenantId": "tnt_acme",
  "projectId": "prj_abc123",
  "environmentIds": ["env_prod"]
}

Response

{
  "projectId": "prj_abc123",
  "name": "Acme web",
  "tenantedDeployments": "Allowed",
  "environments": [
    { "environmentId": "env_prod", "name": "Production" }
  ]
}