# Update a single CSS record

Updates an existing Computer Specific Settings record identified by `computerSettingsId`.

## Endpoint

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

## Request URL

`https://{serverurl}/emsapi/osdeployer/computersettings/{computerSettingsId}`

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

## 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`

- **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 Parameters

### HTTP Code 200

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

- **computerSettingsModifiedStatus** (`boolean`): True if the CSS record was successfully updated.

## 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.