Returns the complete Computer Specific Settings record, including domain, OU, user accounts, and profile backup details.
https://{serverurl}/emsapi/osdeployer/computersettings/{computerSettingsId}
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
ID of OS Deployment ComputerSettings
curl --request GET \
--url https://appdomains/emsapi/osdeployer/computersettings/{computerSettingsId} \
--header 'Accept: application/computerSettingsDetails.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Serial number or MAC address of the machine this CSS record applies to.
Computer name configured for this machine. Present only if a computer name has been set.
Description configured for this machine. Present only if a description has been set.
Domain or workgroup join configuration. Present only if domain settings have been configured.
Internal ID of the configured Active Directory domain.
DNS name of the AD domain to join (e.g., corp.example.com).
ID of the stored credential used to join the domain.
Active Directory OU placement. Present only if OU settings have been configured.
Friendly name of the target Organizational Unit.
Full LDAP distinguished name of the target OU.
User account configuration. Present only if user accounts have been configured.
Local user IDs to provision on the deployed machine.
IDs of pre-configured local users in OS Deployer. Max 5000 entries.
Domain users / groups to add to the machine. Max 5000 entries.
SAM account name of the domain user.
Local group on the deployed machine to add the user to (e.g., Administrators).
Object GUID of the domain user, used for lookup if userName changes.
If true, existing local accounts are removed before applying this configuration.
User profile backup/restore configuration. Present only if profile backup has been configured.
ID of the user-profile backup set to restore.
Individual user profiles to restore from the backup. Min 1, max 5000.
ID of the backed-up user profile to restore.
Password to set for the restored profile. SECRET — never logged.
CSS record with all optional sections populated; restored passwords are masked
{
"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"
}
![]()
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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.