Update Cleanup Settings

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Updates patch cleanup settings.

Request URL

https://{server-hostname}:8383/dcapi/patch/settings/cleanupSettings

Scope

PatchMgmt.UPDATECopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

- Request Body

application/json
JSON Object
Hide Sub-Attributes
cleanupEnabledbooleanOptional

Whether patch cleanup is enabled

cleanupIntervalDaysstringOptional

Interval in days between cleanup runs

cleanupOlderThanDaysstringOptional

Delete patches older than this many days

deleteSupersededPatchesbooleanOptional

Whether to delete superseded patches

deleteDeclinedPatchesbooleanOptional

Whether to delete declined patches

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request PUT \
  --url https://appdomain/dcapi/patch/settings/cleanupSettings \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: application/json' \
  --data '{"cleanupOlderThanDays":90,"cleanupIntervalDays":30,"deleteDeclinedPatches":true,"cleanupEnabled":true,"deleteSupersededPatches":true}'

Sample Request Body

Enable declined patch cleanup

Copied!
  {
    "cleanupOlderThanDays": 90,
    "cleanupIntervalDays": 30,
    "deleteDeclinedPatches": true,
    "cleanupEnabled": true,
    "deleteSupersededPatches": true
  }
                
Show full

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
remarksstring

Confirmation message: Cleanup settings have saved successfully

- HTTP code 401

Response Body - application/json
JSON Object
Hide Sub-Attributes
error_codestring

Error code: UAC_UNAUTHORIZED for missing or invalid credentials

error_descriptionstring

Localized description: dc.rest.authentication.unauthorized

Possible Response Codes

200HTTP code
401HTTP code

Sample Response: HTTP 200

Cleanup settings saved

Copied!
  {
    "remarks": "Cleanup settings have saved successfully"
  }
                
Show full

Sample Response: HTTP 401

Unauthorized access

Copied!
  {
    "error_description": "dc.rest.authentication.unauthorized",
    "error_code": "UAC_UNAUTHORIZED"
  }
                
Show full

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.