---
title: "POST /v2/{+servingConfig}:addControl"
method: POST
path: "/v2/{+servingConfig}:addControl"
tags: ["projects"]
---

# POST /v2/{+servingConfig}:addControl

`POST /v2/{+servingConfig}:addControl`

Enables a Control on the specified ServingConfig. The control is added in the last position of the list of controls it belongs to (e.g. if it's a facet spec control it will be applied in the last position of servingConfig.facetSpecIds) Returns a ALREADY_EXISTS error if the control has already been applied. Returns a FAILED_PRECONDITION error if the addition could exceed maximum number of control allowed for that type of control.

## Path parameters

- `servingConfig` string, required

## Request body

- GoogleCloudRetailV2AddControlRequest — Request for AddControl method.
  - `controlId` string — Required. The id of the control to apply. Assumed to be in the same catalog as the serving config - if id is not found a NOT_FOUND error is returned.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/retail.md) · [All operations](https://skmtc.net/google/apis/retail/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/retail/versions/146c67e59640/schema)