Returns managed resources (computers or users) that can be added as members to a custom group, filtered by group type, category, domain, and search text. Supports pagination and sorting. Use the returned resourceId values in the resourceIds array when calling Create Static CG, Create Static Unique CG, Update Static CG, or Update Static Unique CG. Non-admin users cannot fetch user-type or static-unique category resources.
post /api/1.4/customgroup/availableResources
https://{serverurl}/api/1.4/customgroup/availableResources
DesktopCentralCloud.Common.READCopied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Must be application/json. Request body must be valid JSON.
Must be application/json. Only JSON responses are supported.
Target group category: '1'=Static, '2'=Dynamic, '5'=Static Unique.
Target group type: '1'=Computers, '2'=Users.
Domain NetBIOS names to restrict results (e.g., ['CORP','BRANCH1']). Omit for all domains.
Text filter on resource name — only matching resources returned.
Page number (1-based). Default: 1.
Max resources per page. Default: 30.
Sort direction: 'ASC' (A-Z) or 'DESC' (Z-A), case-insensitive. Default: ASC.
curl --request POST \
--url https://appdomain/api/1.4/customgroup/availableResources \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"groupType":"1","groupCategory":"1"}'Fetch static computer resources filtered by two domains and name prefix.
{
"groupType": "1",
"rangeIndex": "1",
"groupCategory": "1",
"charFilter": "SRV",
"sortOrder": "ASC",
"limit": "30",
"domainFilter": [
"CORP",
"BRANCH1"
]
}
Fetch all available computer resources with only required fields.
{
"groupType": "1",
"groupCategory": "1"
}
Fetch available user resources for a static user group.
{
"groupType": "2",
"rangeIndex": "1",
"groupCategory": "1",
"limit": "50",
"domainFilter": [
"CORP"
]
}
Fetch resources for a static unique computer group.
{
"groupType": "1",
"rangeIndex": "1",
"groupCategory": "5",
"limit": "50",
"domainFilter": [
"CORP"
]
}
Always 'availableResources' for this endpoint.
Response payload container.
Response payload.
Map keyed by resource ID (string). Empty object {} when no resources match.
Unique resource ID — use in resourceIds array when calling Create Static CG, Create Static Unique CG, Update Static CG, or Update Static Unique CG.
Display name: computer hostname or AD username.
NetBIOS domain the resource belongs to.
[Computer groups only] OS platform identifier (e.g., 1=Windows, 2=Mac, 3=Linux). Absent for user groups.
API version: '1.4'.
'success' when the request completed without errors.
Always 'availableResources' for this endpoint.
API version: '1.4'.
Always 'error' for error responses.
Internal error code: '1003' (INTERNAL_ERROR).
Resolved I18N message, typically: An internal error occurred while processing the request.
Computer resources keyed by resource ID with name, domain, and type.
{
"message_type": "availableResources",
"message_response": {
"availableresources": {
"101": {
"resourceId": 101,
"domainName": "CORP",
"name": "SRV-DC01",
"osPlatform": "1"
},
"102": {
"resourceId": 102,
"domainName": "CORP",
"name": "SRV-APP01",
"osPlatform": "1"
},
"201": {
"resourceId": 201,
"domainName": "BRANCH1",
"name": "SRV-FILE01",
"osPlatform": "1"
}
}
},
"message_version": "1.4",
"status": "success"
}
User resources keyed by resource ID for a user group.
{
"message_type": "availableResources",
"message_response": {
"availableresources": {
"501": {
"resourceId": 501,
"domainName": "CORP",
"name": "jsmith"
},
"502": {
"resourceId": 502,
"domainName": "CORP",
"name": "mjones"
}
}
},
"message_version": "1.4",
"status": "success"
}
No resources match the specified filters.
{
"message_type": "availableResources",
"message_response": {
"availableresources": {}
},
"message_version": "1.4",
"status": "success"
}
Unexpected server-side failure retrieving resources.
{
"error_description": "An internal error occurred while processing the request.",
"message_type": "availableResources",
"error_code": "1003",
"message_version": "1.4",
"status": "error"
}
![]()
Duration: 1 minute | Threshold: 30 | 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.