Retrieve the count of configurations currently in trash

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

Retrieves the total count of configurations currently in the trash for the requesting user. Supports optional filters for Software Deployment, Patch Management, or Vulnerability Management modules.

Request URL

https://{serverurl}/dcapi/configuration/trashCount

Scope

DesktopCentralCloud.Configurations.READCopied!

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/configTrashCount.v1+jsonapplication/configTrashCount.v1+jsonCopied!

- Query Parameters

SW_TABbooleanOptional

When true, includes Software Deployment configurations in the trash count.

PatchbooleanOptional

When true, includes Patch Management configurations in the trash count.

VMP_TABbooleanOptional

When true, includes Vulnerability Management configurations in the trash count.

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomains/dcapi/configuration/trashCount \
  --header 'Accept: application/configTrashCount.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'

Response Parameters

- HTTP code 200

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

Total count of configurations currently in trash that match the specified filter criteria and are accessible to the requesting user.

- HTTP code 401

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

Unauthorized error code: credentials missing, expired, or invalid

errorMsgstring

Authentication failure reason

- HTTP code 500

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

50001: internal server error code indicating unexpected exception in the service layer

error_descriptionstring

Internal server error. Contact administrator.

Possible Response Codes

200HTTP code
401HTTP code
500HTTP code

Sample Response: HTTP 200

Trash count across all modules

Copied!
  {
    "trashCount": 15
  }
                
Show full

No items in trash

Copied!
  {
    "trashCount": 0
  }
                
Show full

Sample Response: HTTP 401

User lacks required roles

Copied!
  {
    "error_description": "Access denied - You are not allowed to access the requested resource.",
    "error_code": "UAC_UNAUTHORIZED"
  }
                
Show full

Sample Response: HTTP 500

Unexpected failure while calculating trash count

Copied!
  {
    "error_description": "Internal server error. Contact administrator.",
    "error_code": "50001"
  }
                
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.