Delete the oldest status reports for the account
DELETE /{custNr}/fax/reports
Description
Deletes up to 1000 status reports for completed fax jobs for the current account, starting from the oldest ones. It returns the jobIds of deleted job reports.
In case there are more than 1000 completed job reports, multiple calls of this method might be needed to delete them all.
If you have sent the fax job requests via a high-availability URL, you must send a delete request to both data centers in the processing domain, e.g., US1 and US2 in the case of the USA processing domain. Please do not send a status query or delete request directly to an HA URL, but use the URLs for the specific data centers. Otherwise, it is likely that the fax job has not been processed in the referenced data center, and hence, no status is available there or cannot be deleted.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path | custNr | Customer Number | string |
Responses
HTTP code | Description | Schema |
---|---|---|
200 | Status reports deleted | Response 200 |
400 | BAD_REQUEST: Client authorization is missing | No Content |
401 | AUTHENTICATION_FAILURE: Bad or missing authentication | No Content |
503 | SERVICE_UNAVAILABLE: The server cannot handle the request due to a temporary overloading or maintenance of the server. | No Content |
520 | UNKNOWN_ERROR: Server signals that there was an unknown problem, most likely with the backend adaptor | No Content |
Response 200
Name | Schema |
---|---|
reports | < JobDeleteReport > array |
ExampleHTTP response
Response 200
{
"reports":[
{
"jobId":"FJJ5Y09UM505ZZBIELCRYC",
"deleted":true
},
{
"jobId":"FJJ5WA23UO05ZZBIEL0JY5",
"deleted":true
},
{
"jobId":"FJJ5WA0FWM05ZZBIELZPE4",
"deleted":false,
"reason":"NOT_FOUND"
},
{
"jobId":"FJJ5Y07H3805ZZBIELBAPL",
"deleted":true
},
{
"jobId":"FJJ5WA25VB0BRN8TPSGGVY",
"deleted":false,
"reason":"INTERNAL_ERROR"
},
{
"jobId":"FJJ5WA253505ZZBIELEKRC",
"deleted":true
},
{
"jobId":"FJJ5WA24GI0BRN8TPSWAVM",
"deleted":true
}
]
}