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

# POST /v1/{+name}:attachProject

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

Attach an existing project to the tenancy unit as a new tenant resource. The project could either be the tenant project reserved by calling `AddTenantProject` under a tenancy unit of a service producer's project of a managed service, or from a separate project. The caller is checked against a set of permissions as if calling `AddTenantProject` on the same service consumer. To trigger the attachment, the targeted tenant project must be in a folder. Make sure the ServiceConsumerManagement service account is the owner of that project. These two requirements are already met if the project is reserved by calling `AddTenantProject`. Operation.

## Path parameters

- `name` string, required

## Request body

- AttachTenantProjectRequest — Request to attach an existing project to the tenancy unit as a new tenant resource.
  - `externalResource` string — When attaching an external project, this is in the format of `projects/{project_number}`.
  - `reservedResource` string — When attaching a reserved project already in tenancy units, this is the tag of a tenant resource under the tenancy unit for the managed service's service producer project. The reserved tenant resource must be in an active state.
  - `tag` string — Required. Tag of the tenant resource after attachment. Must be less than 128 characters. Required.

## 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)