---
title: "Patch an existing tenant"
method: PATCH
path: "/msp/v3/customers/{customerID}/tenants/{tenantID}"
tags: ["Tenants"]
---

# Patch an existing tenant

`PATCH /msp/v3/customers/{customerID}/tenants/{tenantID}`

- Patches existing tenant for given customer for the MSP with given details.
- After you initiate the operation, it is queued and a task ID is generated. You can get the task ID from the success response. Use this task ID in the 'Get Task Details' API to track the operation's progress.
- Notes
  -  Enterprise Workloads license is valid for eight years, while a SaaS Apps and Endpoints license is valid for three years.
  - Storage Regions once added, will not be removed.
  - The AWS and Azure storage regions must be in the same geographic location for ‘Business’ edition.
  -  Feature Endpoints, D365 and Okta do not support business edition.
   -  For business edition, there will be only 1 storage region supported.
   -  If a feature is enabled/disabled in service plan it can not be overridden via this API call.
   -  IsEnabled is a required field while specifying tenant features.
   - All the supported attributes are required while updating any feature.
   - Premium Security is only supported for Enterprise Workloads.
   - If 'Premium Security' needs to be enabled for a tenant, Security Posture & Observability and Enterprise Workloads Accelerated Ransomware Recovery features both should be enabled for that tenant. 
   -  For valid products and their Product Features, see - https://developer.druva.com/docs/msp-product-and-attribute-values
   - For valid products and their values, see - https://developer.druva.com/docs/msp-product-and-attribute-values
  - View all supported storage regions here - https://help.druva.com/en/articles/15162912-aws-region-availability-matrix
.

## Path parameters

- `customerID` string, required
- `tenantID` string, required

## Headers

- `Authorization` string, required

## Request body

- PatchTenantRequest — Specify the details for patching existing tenant.
  - `licenseExpiryDate` string, date-time — Specify the new date on which the license of the tenant will expire. The format for this parameter value is YYYY-MM-DDTHH:MM:SSZ. Example - '2022-10-25T00:00:00Z'
  - `quota` number, double — Specify the new value of Druva Consumption Units that should be allocated to the customer. If the customer is close to breaching this limit, an alert is sent to the configured email address based on the severity of the breach. Example - 1.5
  - `quotaStartDate` string, date-time — Specify the new date from when the Quota limit is applicable to the customer and the storage consumption begins. The format for this parameter value is YYYY-MM-DDTHH:MM:SSZ. Example - '2022-10-15T00:00:00Z'
  - `quotaEndDate` string, date-time — Specify the new date when the allocated Quota limit will expire. After the Quota limit expires, the customer cannot back up the data. The format for this parameter value is YYYY-MM-DDTHH:MM:SSZ. Example - '2022-10-15T00:00:00Z'
  - `servicePlanID` integer — - Specify the unique ID of the Service Plan that you wish to associate with the tenant. - Get the Service Plan ID using the 'List Service Plans' API.
  - `tenantType` integer — Specify the tenant type for the product. - Specify '1' if it is a Sandbox. - Specify '2' if it is Evaluation. This is a trial plan with a validity of 30 days. If you select this tenant type, the product license will be active until 30 days. After 30 days, you must change the tenant type to Commercial. - Specify '3' if it is Commercial. For this tenant type, a Enterprise Workloads license is valid for eight years, while a SaaS Apps and Endpoints license is valid for three years.
  - `storageRegions` StorageRegions[] — - Specify the storage regions where you want to store the tenant data specifying the 'name' of storage region and its associated storage provider. - Storage Provider values: 1 (AWS), 2 (Azure)
    - `name` string — - Name of the storage region. Example - 'us-east-1'
    - `storageProvider` integer — - Storage Provider (AWS/Azure) that is associated with the storage region. Storage Provider values: 1 (AWS), 2 (Azure)
  - `features` PatchTenantFeatures[] — Specify the new list of features that needs to be enabled/disabled for the tenant. All the supported attributes are required while updating any feature.
    - `name` string — - Name of the feature. Example - 'M365' - For valid products and their values, see - https://developer.druva.com/docs/msp-product-and-attribute-values
    - `isEnabled` boolean — - Feature state for tenant. - isEnabled can be true or false. Example - true
    - `attrs` FeatureAttributeForV3[] — - Attributes to be enabled for tenant. - Attrs can be empty. Example - [] - For valid products and their values, see - https://developer.druva.com/docs/msp-product-and-attribute-values
      - `name` string — Specify the name of the attribute. Example - 'userCount', 'preservedUserCount'
      - `value` object — Specify the value of the attribute. Example - 100

## Response `200`

Ok

- TaskCreatedResponse
  - `task` object
    - `id` string — The task ID of the operation, and can be used to track the progress. Use this task ID in the 'Get Task Details' API to track the operation's progress. Example - 'c8b54819-486a-497a-b86e-5b93f2422711'.

## Other responses

- `400` — Bad Request
- `500` — The request was not processed due to an internal error in MSP Portal Service.

---

[API](https://skmtc.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/revisions/2af2bf148b25/schema)