Updates the metadata of an existing script, such as its description, arguments, successful exit codes, and sharing setting. The script file itself is replaced through the Update Script File API.
https://{serverurl}/dcapi/configuration/scriptRepository/{scriptId} Copied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Unique identifier of the script to update. Fetch from List Scripts.
The uploaded script file to register. Upload the file first (POST /emsapi/files) and pass the returned fileID here.
Identifier of the uploaded script file. Upload the file first (POST /emsapi/files) and pass the fileID returned by that call.
Default command-line arguments passed to the script when it runs. Masked in responses.
Operating system the script targets. Allowed values:
Windows
Mac
Linux
Free-text description of what the script does.
Comma-separated list of exit codes to treat as success (e.g., "0,1"). Any other exit code marks the execution as failed.
Existing script identifier. Omit when adding a new script.
curl --request POST \
--url https://appdomains/dcapi/configuration/scriptRepository/{scriptId} \
--header 'Accept: application/updateScriptStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/scriptDetails.v1+json' \
--data '{"scriptFile":{"fileID":12345}}'Modify a Windows script's arguments, description, and exit codes
{
"scriptID": 67890,
"description": "Updated script description",
"exitCodes": "0,1,2",
"arguments": "--timeout 30",
"scriptFile": {
"fileID": 12345
},
"platform": "Windows"
}
false when the user does not have permission to modify the script
Reason for access denial
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
User does not have permission to modify this script
{
"accessDeniedReason": "createdByDifferentUser",
"allowAccess": false
}
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 during script modification
{
"errorCode": 1003,
"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.