# Update a single CSS record

Updates an existing Computer Specific Settings record identified by computerSettingsId.

## Endpoint

`PUT /emsapi/osdeployer/computersettings/{computerSettingsId}`

## Request

### Request URL

`https://`[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/emsapi/osdeployer/computersettings/{computerSettingsId}`

### Scope

`DesktopCentralCloud.OSDComputerSettings.UPDATE`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Content-Type** `string` **Mandatory**: `application/computerSettingsDetails.v1+json`
- **Accept** `string` **Mandatory**: `application/computerSettingsModifiedStatus.v1+json`

#### Path Parameters

- **computerSettingsId** `string` **Mandatory**: ID of OS Deployment ComputerSettings

#### Request Body

`application/json`

- `JSON Object`
  - **serialOrMAC** `string` **Mandatory**: Target machine identifier — serial number or MAC address. Length 4-255, alphanumeric/colon/hyphen allowed.
  - **computerName** `string` **Mandatory**: Computer name to be assigned post-deployment. Matches osd_machinename regex.
  - **computerDescription** `string` **Optional**: Free-form description for the target machine. Max 1024 chars.
  - **domainInfo** `JSON Object` **Mandatory**: Domain to join after image deployment. Optional.
  - **ouInfo** `JSON Object` **Optional**: Organizational Unit placement within the domain. Optional.
  - **userAccounts** `JSON Object` **Optional**: Local and domain user accounts to provision on the deployed machine.
  - **userProfileBackup** `JSON Object` **Optional**: User-profile backup to restore on the deployed machine. Optional.

### Sample Request

```curl
curl --request PUT \
  --url https://appdomains/emsapi/osdeployer/computersettings/{computerSettingsId} \
  --header 'Accept: application/computerSettingsModifiedStatus.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/computerSettingsDetails.v1+json' \
  --data '{"domainInfo":{"domainName":"hq.example.com","credentialID":51,"domainID":1002},"computerName":"WIN-DESK-001","serialOrMAC":"AA:BB:CC:DD:EE:FF"}'
```

### Sample Request Body

Update domain and OU of an existing CSS record

```json
{
  "userProfileBackup": {
    "backupID": 9002,
    "userProfiles": [
      {
        "password": "********",
        "backupUserID": 8
      }
    ]
  },
  "domainInfo": {
    "domainName": "hq.example.com",
    "credentialID": 51,
    "domainID": 1002
  },
  "computerName": "WIN-DESK-001",
  "serialOrMAC": "AA:BB:CC:DD:EE:FF",
  "ouInfo": {
    "distinguishedName": "OU=HQ-Sales,DC=hq,DC=example,DC=com",
    "ouName": "HQ-Sales"
  },
  "userAccounts": {
    "deleteExistingUsers": true,
    "localUsers": {
      "userIDs": [
        1
      ]
    },
    "domainUsers": []
  },
  "computerDescription": "Re-imaged sales laptop"
}
```

## Response

### HTTP Code 200

Response Body: `application/computerSettingsModifiedStatus.v1+json`

- `JSON Object`
  - **computerSettingsModifiedStatus** `boolean`: True if the CSS record was successfully updated.

### Possible Response Codes

- **200** `HTTP code`

### Sample Response: HTTP 200

CSS record updated

```json
{
  "computerSettingsModifiedStatus": true
}
```

## Rate Limits

**Duration:** 1 minute | **Threshold:** 50 | **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.