# Create Computer Specific Settings record

Creates a new CSS record targeting a specific machine by Serial Number or MAC address, overriding deployment template defaults — such as computer name, domain, OU, user accounts, and profile backup — for a single endpoint.

## Endpoints

**POST** `/emsapi/osdeployer/computersettings`

## Request URL

`https://{server-hostname}:8383/emsapi/osdeployer/computersettings`

## Scope

`OSDComputerSettings.CREATE`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Content-Type** `string` — **Mandatory**
  - `application/computerSettingsDetails.v1+json`
- **Accept** `string` — **Mandatory**
  - `application/computerSettingsAddedStatus.v1+json`

### 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
curl --request POST \
  --url https://appdomain/emsapi/osdeployer/computersettings \
  --header 'Accept: application/computerSettingsAddedStatus.v1+json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/computerSettingsDetails.v1+json' \
  --data '{"userProfileBackup":{"backupID":9001,"userProfiles":[{"password":"********","backupUserID":7}]},"domainInfo":{"domainName":"corp.example.com","credentialID":50,"domainID":1001},"computerName":"WIN-DESK-001","serialOrMAC":"AA:BB:CC:DD:EE:FF","ouInfo":{"distinguishedName":"OU=Sales,DC=corp,DC=example,DC=com","ouName":"Sales"},"userAccounts":{"deleteExistingUsers":false,"localUsers":{"userIDs":[1,2]},"domainUsers":[{"groupName":"Administrators","guid":"abc-123","userName":"jdoe"}]},"computerDescription":"Sales laptop"}'
```

### Sample Request Body

CSS with domain-join post-actions, local user assignments, and user-profile backup restore

```json
{
  "userProfileBackup": {
    "backupID": 9001,
    "userProfiles": [
      {
        "password": "********",
        "backupUserID": 7
      }
    ]
  },
  "domainInfo": {
    "domainName": "corp.example.com",
    "credentialID": 50,
    "domainID": 1001
  },
  "computerName": "WIN-DESK-001",
  "serialOrMAC": "AA:BB:CC:DD:EE:FF",
  "ouInfo": {
    "distinguishedName": "OU=Sales,DC=corp,DC=example,DC=com",
    "ouName": "Sales"
  },
  "userAccounts": {
    "deleteExistingUsers": false,
    "localUsers": {
      "userIDs": [
        1,
        2
      ]
    },
    "domainUsers": [
      {
        "groupName": "Administrators",
        "guid": "abc-123",
        "userName": "jdoe"
      }
    ]
  },
  "computerDescription": "Sales laptop"
}
```

## Response Parameters

### HTTP Code 200

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

- `JSON Object`
  - **computerSettingsAddedStatus** `boolean`
    - True if the CSS record was successfully created.
  - **computerSettingsIDs** `array`
    - List containing the ID of the newly created CSS record.

### Possible Response Codes

- **200** `HTTP code`

### Sample Response: HTTP 200

CSS record created

```json
{
  "computerSettingsAddedStatus": true,
  "computerSettingsIDs": [
    1234
  ]
}
```

## Rate Limit

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