# Modify an existing ADCS server configuration

Update the individual AD Certificate server details.

## Endpoints

`PUT /api/v1/mdm/adcs/servers/{ad_config_id}`

## Request URL

`https://{server-hostname}:8383/api/v1/mdm/adcs/servers/{ad_config_id}`

## Scope

`MDMDeviceMgmt.UPDATE`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Content-Type** (`string`, Mandatory): `application/json`
- **Accept** (`string`, Mandatory): `application/json`

### Path Parameters

- **ad_config_id** (`string`, Mandatory): Unique identifier of the ADCS configuration to modify. Use the ad_config_id from the [Add ADCS Server API](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mac-add-adcs-server.html) response.

### Request Body

`application/json`

- **ad_config_name** (`string`, Mandatory): Name of the ADCS configuration. Must be unique across the organization.
- **cert_server_address** (`string`, Mandatory): URL of the ADCS server (e.g., [http://adcs.zylker.com/certsrv/)](http://adcs.zylker.com/certsrv/%29)).
- **cert_authority** (`string`, Mandatory): Common Name (CN) of the Certificate Authority (e.g., `CN=ZylkerCA-SERVER-CA`).
- **cert_template_name** (`string`, Mandatory): Template name of the certificate configured in the ADCS server.
- **description** (`string`, Optional): Description of the ADCS server configuration. Defaults to `'--'` if not provided.
- **cert_exp_notify_thread** (`integer`, Optional): Number of days before certificate expiry to notify. Defaults to `14` if not provided.
- **rsa_key_size** (`integer`, Optional): RSA key size for the certificate. Allowed values: `0` (1024), `1` (2048), `2` (4096). Defaults to `1` (2048) if not provided.
- **auto_renew_enabled** (`boolean`, Optional): Whether auto-renewal is enabled for the certificate. Defaults to `false` if not provided.
- **allow_all_apps_to_access** (`boolean`, Optional): Whether all apps can access the certificate. Defaults to `false` if not provided.
- **is_key_extractable** (`boolean`, Optional): Whether the private key is extractable. Defaults to `false` if not provided.
- **redistribute_profiles** (`boolean`, Optional): Whether to redistribute associated profiles after modification. Defaults to `false` if not provided.

## Sample Request

```curl
curl --request PUT \
  --url https://appdomain/api/v1/mdm/adcs/servers/{ad_config_id} \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"ad_config_name":"computer_1_updated","cert_authority":"CN=zylker-SERVER-CA2","auto_renew_enabled":true,"cert_exp_notify_thread":14,"is_key_extractable":false,"allow_all_apps_to_access":true,"description":"Updated ADCS server configuration","cert_template_name":"computer_1","cert_server_address":"http://cert.zylker.com/certsrv/","rsa_key_size":1,"redistribute_profiles":false}'
```

### Sample Request Body

Modify an existing ADCS server configuration.

```json
{
  "ad_config_name": "computer_1_updated",
  "cert_authority": "CN=zylker-SERVER-CA2",
  "auto_renew_enabled": true,
  "cert_exp_notify_thread": 14,
  "is_key_extractable": false,
  "allow_all_apps_to_access": true,
  "description": "Updated ADCS server configuration",
  "cert_template_name": "computer_1",
  "cert_server_address": "http://cert.zylker.com/certsrv/",
  "rsa_key_size": 1,
  "redistribute_profiles": false
}
```

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

- **ad_config_id** (`long`): Unique identifier of the modified ADCS configuration.

### HTTP Code 400

Response Body — `application/json`

- **error_code** (`string`): Error code: `ADCS0001` — ADCS configuration name already exists.
- **error_description** (`string`): Human-readable error description.
- **localized_error_description** (`string`): Localized error description for display.

## Possible Response Codes

- `200` — HTTP code
- `400` — HTTP code

## Sample Response: HTTP 200

ADCS server configuration successfully modified.

```json
{
  "ad_config_id": 9007199254740996
}
```

## Sample Response: HTTP 400

ADCS configuration name already exists.

```json
{
  "error_description": "ADCS configuration name already exists.",
  "error_code": "ADCS0001",
  "localized_error_description": "ADCS configuration name already exists."
}
```

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 60 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.