Retrieve the count of configurations currently in trash 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://{server-hostname}:8383/dcapi/configuration/trashCount
Scope
Header Authorization: d92d4xxxxxxxxxxxxx15f52
Request Parameters - Request Headers Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
--url https://appdomain/dcapi/configuration/trashCount \
--header 'Accept: application/configTrashCount.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;
public class Main {
public static void main(String[] args) {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://appdomain/dcapi/configuration/trashCount"))
.header("Accept", "application/configTrashCount.v1+json")
.header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
headers = {
'Accept': "application/configTrashCount.v1+json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("GET", "/dcapi/configuration/trashCount", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Accept", "application/configTrashCount.v1+json");
response = invokeUrl
[
url: "https://appDomain/dcapi/configuration/trashCount"
type: GET
headers: headersMap
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Accept", "application/configTrashCount.v1+json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/configuration/trashCount' -Method GET -Headers $headers▼ Show full
Response Parameters - HTTP code 200 Response Body - application/json JSON object
Hide Sub-Attributes trashCount string
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 errorCode long
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
errorMsg string
Authentication failure reason
- HTTP code 500 Response Body - application/json JSON object
Hide Sub-Attributes error_code string
50001: internal server error code indicating unexpected exception in the service layer
error_description string
Internal server error. Contact administrator.
Possible Response Codes Sample Response: HTTP 200 Trash count across all modules
Copied!
{
"trashCount": 15
}
▼ Show full
{
"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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.