Returns every script in the Script Repository that is visible to the logged-in user. Use the returned scriptId when creating a Custom Script configuration policy with executionType Repository.
get /dcapi/configuration/scripts
https://{serverurl}/dcapi/configuration/scripts Copied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Restrict the list to one platform. Allowed values:
Windows
Mac
Linux
All
The value is not case sensitive
Default: All
Zero-based index of the first script to return. Use it with limit to page through the list. Default: 0
Number of scripts to return in one page. Allowed values: 1 to 1000. Default: 30
Return only scripts whose file name contains this text. The match is case insensitive. Default: no filter
curl --request GET \
--url https://appdomains/dcapi/configuration/scripts \
--header 'Accept: application/scripts.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'A single script summary entry
Unique script ID. Pass it as scriptId when creating a Custom Script configuration policy with executionType repository
Filename of the script
Platform the script targets. Allowed values:
1 = Windows
2 = Mac
3 = Linux
Default command-line arguments stored with the script. Decrypted before it is returned for Windows scripts. Empty when no arguments were saved
true when a dynamic argument JSON file is associated with the script
Exit codes treated as success. Comma-separated list; scripts created before multi-exit-code support return a single numeric code
Description of the script
Product error code for the authorization failure
Localised error message for the error code
Product error code for the failure
Localised error message for the error code
Paginated list of scripts filtered by platform
[
{
"scriptId": 12345,
"isDynamicArgsPresent": false,
"scriptArguments": "--timezone IST",
"scriptName": "ChangeTimeZone.bat",
"exitCodes": "0,1",
"description": "Batch Script to change timezone",
"platformID": 1
},
{
"scriptId": 12346,
"isDynamicArgsPresent": false,
"scriptArguments": "",
"scriptName": "CleanTempFiles.sh",
"exitCodes": "0",
"description": "Shell script to clean temp files",
"platformID": 3
}
]
The API user does not have the role required for this operation
{
"errorCode": 1001,
"errorMsg": "Access denied - You are not allowed to access the requested resource."
}
Unexpected server error while listing scripts
{
"errorCode": 50001,
"errorMsg": "An Internal Error occurred, try again later."
}
![]()
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.