# Update an existing FileVault encryption settings configuration

Update the individual filevault details

## Endpoint

`PUT /api/v1/mdm/profiles/filevaults/{encryption_settings_id}`

## Request URL

`https://{server-hostname}:8383/api/v1/mdm/profiles/filevaults/{encryption_settings_id}`

### Scope

`MDMDeviceMgmt.UPDATE`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

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

### Path Parameters

- **encryption_settings_id** (`string`, Mandatory): Unique identifier of the encryption settings to modify. Obtain from the [Create FileVault Encryption Settings](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mac-add-filevault-encryption-settings.html) or [Get FileVault Encryption Settings](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mac-get-filevault-encryption-settings.html) response.

### Request Body

`application/json`

- `mdmencryptionsettings` (JSON Object, Mandatory): Core encryption settings including name and type.
- `mdmfilevaultsettings` (JSON Object, Optional): FileVault-specific settings including recovery key options and user messages.
- `mdmfilevaultpersonalkeyconfiguration` (JSON Object, Optional): Personal recovery key configuration (used when `encryption_settings_type` is 1 or 3).
- `mdmfilevaultinstitutionconfiguration` (JSON Object, Optional): Institutional recovery key configuration (used when `encryption_settings_type` is 2 or 3).

## Sample Request

```curl
curl --request PUT \
  --url https://appdomain/api/v1/mdm/profiles/filevaults/{encryption_settings_id} \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"mdmfilevaultsettings":{"dont_allow_filevault_disable":true,"recovery_key_type":1,"message_to_user":"Contact IT to retrieve your recovery key."},"mdmfilevaultpersonalkeyconfiguration":{"show_recovery_key":true,"enable_ec_agent_prk_rotation":true},"mdmencryptionsettings":{"encryption_settings_type":1,"settings_name":"Updated FileVault Settings"}}'
```

## Sample Request Body

Modify FileVault encryption settings

```json
{
  "mdmfilevaultsettings": {
    "dont_allow_filevault_disable": true,
    "recovery_key_type": 1,
    "message_to_user": "Contact IT to retrieve your recovery key."
  },
  "mdmfilevaultpersonalkeyconfiguration": {
    "show_recovery_key": true,
    "enable_ec_agent_prk_rotation": true
  },
  "mdmencryptionsettings": {
    "encryption_settings_type": 1,
    "settings_name": "Updated FileVault Settings"
  }
}
```

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

- `mdmencryptionsettings` (JSON Object): Core encryption settings with assigned `encryption_settings_id`.
- `mdmfilevaultsettings` (JSON Object): FileVault-specific settings.
- `mdmfilevaultpersonalkeyconfiguration` (JSON Object): Personal recovery key configuration with assigned certificate IDs (present when `encryption_settings_type` is 1 or 3).
- `mdmfilevaultinstitutionconfiguration` (JSON Object): Institutional recovery key configuration (present when `encryption_settings_type` is 2 or 3).

## Possible Response Codes

- **200**: HTTP code

## Sample Response: HTTP 200

FileVault encryption settings successfully modified

```json
{
  "mdmfilevaultsettings": {
    "copy_recovery_key_to_mdm": true,
    "dont_allow_filevault_disable": true,
    "recovery_key_type": "3",
    "maximum_attempts_to_force": "-1",
    "force_encryption_until_logout": false,
    "ask_enable_during_logout": false,
    "message_to_user": "Contact IT to retrieve your recovery key."
  },
  "mdmfilevaultinstitutionconfiguration": {
    "institution_encryption_cert": "6967000001030029"
  },
  "mdmfilevaultpersonalkeyconfiguration": {
    "show_recovery_key": true,
    "recovery_key_identifier": "6967000001030023",
    "enable_ec_agent_prk_rotation": true,
    "recovery_encrypt_cert_id": "6967000001030023"
  },
  "mdmencryptionsettings": {
    "modified_user": "6967000000047005",
    "added_time": "1777444564220",
    "modified_time": "1777544564220",
    "encryption_settings_type": "3",
    "added_user": "6967000000047005",
    "settings_desc": "",
    "customer_id": "6967000000047017",
    "encryption_settings_id": "6967000001030020",
    "settings_name": "Updated FileVault Settings"
  }
}
```

![](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.