---
title: "Modifies an existing Tenant."
method: PUT
path: "/tenants/{id}"
tags: ["Tenants"]
---

# Modifies an existing Tenant.

`PUT /tenants/{id}`

## Path parameters

- `id` string, required

## Request body

- ModifyTenantCommand
  - `Description` string
  - `Id` string, required
  - `IsDisabled` boolean
  - `Name` string, required
  - `ProjectEnvironments` object — The complete set of projects the tenant is connected to, as an object keyed by project ID where each value is the array of environment IDs the tenant can deploy to for that project. Example: {"Projects-1": ["Environments-1"]}. Replaces the tenant's current connections; omitting an existing project disconnects it and deletes the tenant's variable values for it.
  - `Slug` string — A URL-friendly, unique identifier for the tenant. Resubmit the tenant's current slug unless you intend to change it; changing it breaks existing links that use the old slug.
  - `SpaceId` string, required
  - `TenantTags` string[] — The complete set of tags for the tenant, as canonical tag names in the form 'TagSetName/TagName'. Example: ["Regions/EU-West", "Tier/Premium"]. Replaces the tenant's current tags; any existing tag omitted here is removed.

## Response `200`

Confirms that a Tenant has been modified, containing the updated Tenant

- TenantResource
  - `ClonedFromTenantId` string
  - `CustomFields` string[]
  - `Description` string
  - `Icon` IconResource
    - `Color` string
    - `Id` string
  - `Id` string
  - `IsDisabled` boolean
  - `LastModifiedBy` string
  - `LastModifiedOn` string, date-time
  - `Links` object
  - `Name` string
  - `ProjectEnvironments` object
  - `Slug` string
  - `SpaceId` string
  - `TenantTags` string[]

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/versions/bc9158facfc7/schema)