---
title: "POST /v1/{+name}:applyProjectConfig"
method: POST
path: "/v1/{+name}:applyProjectConfig"
tags: ["services"]
---

# POST /v1/{+name}:applyProjectConfig

`POST /v1/{+name}:applyProjectConfig`

Apply a configuration to an existing tenant project. This project must exist in an active state and have the original owner account. The caller must have permission to add a project to the given tenancy unit. The configuration is applied, but any existing settings on the project aren't modified. Specified policy bindings are applied. Existing bindings aren't modified. Specified services are activated. No service is deactivated. If specified, new billing configuration is applied. Omit a billing configuration to keep the existing one. A service account in the project is created if previously non existed. Specified labels will be appended to tenant project, note that the value of existing label key will be updated if the same label key is requested. The specified folder is ignored, as moving a tenant project to a different folder isn't supported. The operation fails if any of the steps fail, but no rollback of already applied configuration changes is attempted. Operation.

## Path parameters

- `name` string, required

## Request body

- ApplyTenantProjectConfigRequest — Request to apply configuration to an existing tenant project.
  - `tag` string — Required. Tag of the project. Must be less than 128 characters. Required.
  - `projectConfig` TenantProjectConfig — This structure defines a tenant project to be added to the specified tenancy unit and its initial configuration and properties. A project lien is created for the tenant project to prevent the tenant project from being deleted accidentally. The lien is deleted as part of tenant project removal.
    - `labels` object — Labels that are applied to this project.
    - `serviceAccountConfig` ServiceAccountConfig — Describes the service account configuration for the tenant project.
      - `accountId` string — ID of the IAM service account to be created in tenant project. The email format of the service account is "@.iam.gserviceaccount.com". This account ID must be unique within tenant project and service producers have to guarantee it. The ID must be 6-30 characters long, and match the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])`.
      - `tenantProjectRoles` string[] — Roles for the associated service account for the tenant project.
    - `folder` string — Folder where project in this tenancy unit must be located This folder must have been previously created with the required permissions for the caller to create and configure a project in it. Valid folder resource names have the format `folders/{folder_number}` (for example, `folders/123456`).
    - `services` string[] — Google Cloud API names of services that are activated on this project during provisioning. If any of these services can't be activated, the request fails. For example: 'compute.googleapis.com','cloudfunctions.googleapis.com'
    - `billingConfig` BillingConfig — Describes the billing configuration for a new tenant project.
      - `billingAccount` string — Name of the billing account. For example `billingAccounts/012345-567890-ABCDEF`.
    - `tenantProjectPolicy` TenantProjectPolicy — Describes policy settings that can be applied to a newly created tenant project.
      - `policyBindings` PolicyBinding[] — Policy bindings to be applied to the tenant project, in addition to the 'roles/owner' role granted to the Service Consumer Management service account.
        - `members` string[] — Uses the same format as in IAM policy. `member` must include both a prefix and ID. For example, `user:{emailId}`, `serviceAccount:{emailId}`, `group:{emailId}`.
        - `role` string — Role. (https://cloud.google.com/iam/docs/understanding-roles) For example, `roles/viewer`, `roles/editor`, or `roles/owner`.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/serviceconsumermanagement.md) · [All operations](https://skmtc.dev/google/apis/serviceconsumermanagement/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/serviceconsumermanagement/revisions/4ccbdb61fd14/schema)