CdmPoliciesApi

</td></tr><tr><td>

additionalDeployables.appName

</td><td>

Required. Name of the CDM application to which the deployable is associated.Data type: String

Table: CDM Application \[sn\_cdm\_application\]

</td></tr><tr><td>

additionalDeployables.deployableName

</td><td>

Required. Name of the CDM deployable to add to the additionalDeployablesInput input variable.Data type: String

Table: CDM Deployable \[sn\_cdm\_deployable\]

</td></tr><tr id="appName-policy-row"><td>

appName

</td><td>

Required. Name of the CDM application for which to update the additionalDeployablesInput input variable.Data type: String

Table: CDM Application \[sn\_cdm\_application\]

</td></tr><tr id="deployableName-policy-row"><td>

deployableName

</td><td>

Required. Name of the CDM deployable for which to update the additionalDeployablesInput input variable.Data type: String

Table: CDM Deployable \[sn\_cdm\_deployable\]

</td></tr><tr><td>

policyName

</td><td id="policyName-policy-entry">

Required. Name of the associated policy.Data type: String

Table: Policy \[sn\_pace\_policy\]

</td></tr><tr><td>

returnFields

</td><td id="cdm_apps-returnFields-entry">

List of fields to return as part of the response. Pass the record column names such as sys\_id, sys\_updated\_by, or state.Data type: Array

Default: All fields as determined by the endpoint

</td></tr></tbody>
</table>

|Name|Description|
|----|-----------|
|None| |

### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](../rest-api-explorer/c_RESTAPI.md).

|Header|Description|
|------|-----------|
|Accept|Data format of the response body. Only supports **application/json**.|
|Content-Type|Data format of the request body. Only supports **application/json**.|

|Header|Description|
|------|-----------|
|None| |

### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](../rest-api-explorer/c_RESTAPI.md).

|Status code|Description|
|-----------|-----------|
|200|Successful. The request was successfully processed.|
|400|Bad Request. The **policyName** parameter passed is invalid.|
|500|Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.|

### Response body parameters

<table id="id_jx1_px2_c5b"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

io\_definition

</td><td>

Details about the associated PaCE IO definition record.For additional information on PaCE, see <a href="../../../servicenow-platform/policy-as-code-engine-pace/pace-managing-policies/">Policy as Code Engine (PaCE)</a>.

Data type: Object

</td></tr><tr><td>

io\_definition.link

</td><td>

Call syntax for querying this PaCE IO definition record using the Table REST API.Data type: String

</td></tr><tr><td>

io\_definition.value

</td><td>

Sys\_id of the PaCE IO definition record. Data type: String

Table: IO Mapping \[sn\_pace\_io\_mapping\]

</td></tr><tr><td>

is\_unused

</td><td>

Flag that indicates whether the mapping input variable is unused.Possible values:

-   true: Associated mapping input variable isn't currently used.
-   false: Associated mapping input variable is currently used.

Data type: Boolean

</td></tr><tr><td>

mapped\_value

</td><td>

Current value of the mapping input variable.Data type: Array of Objects or String

</td></tr><tr><td>

policy\_mapping

</td><td>

Details about the PaCE policy-mapping record.For additional information on PaCE, see <a href="../../../servicenow-platform/policy-as-code-engine-pace/pace-managing-policies/">Policy as Code Engine (PaCE)</a>.

Data type: Object

</td></tr><tr><td>

policy\_mapping.link

</td><td>

Call syntax for querying the policy mapping record using the Table REST API.Data type: String

</td></tr><tr><td>

policy\_mapping.value

</td><td>

Sys\_id of the PaCE policy-mapping record.Data type: String

Table: Policy Mapping \[sn\_pace\_policy\_mapping\]

</td></tr><tr><td>

sys\_created\_by

</td><td>

Name of the user that created the mapping input variable.Data type: String

</td></tr><tr><td>

sys\_created\_on

</td><td>

Date and time when the mapping input variable was created.Data type: String

Format: yyyy-mm-dd hh:mm:ss

</td></tr><tr><td>

sys\_id

</td><td>

Sys\_id of the associated mapping record.Data type: String

Table: IO Mapping \[sn\_pace\_io\_mapping\]

</td></tr><tr><td>

sys\_updated\_by

</td><td>

Name of the user that updated the mapping input variable.Data type: String

</td></tr><tr><td>

sys\_updated\_on

</td><td>

Date and time when the mapping input variable was last updated.Data type: String

Format: yyyy-mm-dd hh:mm:ss

</td></tr></tbody>
</table>

### cURL request

The following example shows how to add deployables to an additionalDeployablesInput input variable.

Return result:

## CdmPoliciesApi - PUT /sn\_cdm/policies/mappings/inputs

Updates a specified input variable for a Configuration Data Management \(CDM\) policy mapping.

For additional information on policy mappings, see [Map policies to a deployable](../../it-service-management/devops-family/cdm-deployable-map-policy-to.md).

The caller of this endpoint must have the CDM Admin role.

### URL format

Versioned URL: `/api/sn_cdm/{api_version}/policies/mappings/inputs`

Default URL: `/api/sn_cdm/policies/mappings/inputs`

**Note:** Available versions are specified in the [REST API Explorer](../rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](../rest-api-explorer/c_CustomWebServices.md).

### Supported request parameters

<table class="rest_api_path_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api\_version

</td><td id="version-entry-RESTAPI">

Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String

</td></tr></tbody>
</table>

<table class="rest_api_query_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr id="appName-policy-row"><td>

appName

</td><td>

Required. Name of the CDM application for which to update the policy mapping inputs.Data type: String

Table: CDM Application \[sn\_cdm\_application\]

</td></tr><tr id="deployableName-policy-row"><td>

deployableName

</td><td>

Required. Name of the CDM deployable for which to update the policy mapping inputs.Data type: String

Table: CDM Deployable \[sn\_cdm\_deployable\]

</td></tr><tr><td>

inputName

</td><td>

Required. Name of the input variable to update.Data type: String

Table: IO Mapping \[sn\_pace\_io\_mapping\]

</td></tr><tr><td>

inputValue

</td><td>

Required. Value to assign to the input variable.Data type: Dependant on the input variable. You can find the data type in the IO Mapping \[sn\_pace\_io\_mapping\] table.

</td></tr><tr><td>

policyName

</td><td id="policyName-policy-entry">

Required. Name of the associated policy.Data type: String

Table: Policy \[sn\_pace\_policy\]

</td></tr><tr><td>

returnFields

</td><td id="cdm_apps-returnFields-entry">

List of fields to return as part of the response. Pass the record column names such as sys\_id, sys\_updated\_by, or state.Data type: Array

Default: All fields as determined by the endpoint

</td></tr></tbody>
</table>

|Name|Description|
|----|-----------|
|None| |

### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](../rest-api-explorer/c_RESTAPI.md).

|Header|Description|
|------|-----------|
|Accept|Data format of the response body. Only supports **application/json**.|
|Content-Type|Data format of the request body. Only supports **application/json**.|

|Header|Description|
|------|-----------|
|None| |

### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](../rest-api-explorer/c_RESTAPI.md).

|Status code|Description|
|-----------|-----------|
|200|Successful. The request was successfully processed.|
|400|Bad Request. The **policyName** parameter passed is invalid.|
|500|Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.|

### Response body parameters

<table id="id_tny_nx2_c5b"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

io\_definition

</td><td>

Details about the associated PaCE IO definition record.For additional information on PaCE, see <a href="../../../servicenow-platform/policy-as-code-engine-pace/pace-managing-policies/">Policy as Code Engine (PaCE)</a>.

Data type: Object

</td></tr><tr><td>

io\_definition.link

</td><td>

Call syntax for querying this PaCE IO definition record using the Table REST API.Data type: String

</td></tr><tr><td>

io\_definition.value

</td><td>

Sys\_id of the PaCE IO definition record. Data type: String

Table: IO Mapping \[sn\_pace\_io\_mapping\]

</td></tr><tr><td>

is\_unused

</td><td>

Flag that indicates whether the mapping input variable is unused.Possible values:

-   true: Associated mapping input variable isn't currently used.
-   false: Associated mapping input variable is currently used.

Data type: Boolean

</td></tr><tr><td>

mapped\_value

</td><td>

Current value of the mapping input variable.Data type: Array of Objects or String

</td></tr><tr><td>

policy\_mapping

</td><td>

Details about the PaCE policy-mapping record.For additional information on PaCE, see <a href="../../../servicenow-platform/policy-as-code-engine-pace/pace-managing-policies/">Policy as Code Engine (PaCE)</a>.

Data type: Object

</td></tr><tr><td>

policy\_mapping.link

</td><td>

Call syntax for querying the policy mapping record using the Table REST API.Data type: String

</td></tr><tr><td>

policy\_mapping.value

</td><td>

Sys\_id of the PaCE policy-mapping record.Data type: String

Table: Policy Mapping \[sn\_pace\_policy\_mapping\]

</td></tr><tr><td>

sys\_created\_by

</td><td>

Name of the user that created the mapping input variable.Data type: String

</td></tr><tr><td>

sys\_created\_on

</td><td>

Date and time when the mapping input variable was created.Data type: String

Format: yyyy-mm-dd hh:mm:ss

</td></tr><tr><td>

sys\_id

</td><td>

Sys\_id of the associated mapping record.Data type: String

Table: IO Mapping \[sn\_pace\_io\_mapping\]

</td></tr><tr><td>

sys\_updated\_by

</td><td>

Name of the user that updated the mapping input variable.Data type: String

</td></tr><tr><td>

sys\_updated\_on

</td><td>

Date and time when the mapping input variable was last updated.Data type: String

Format: yyyy-mm-dd hh:mm:ss

</td></tr></tbody>
</table>

### cURL request

The following example shows how to update the key1 input variable associated with the testALPolicy.

Return results: