Skip to main content
Skip table of contents

Delete the oldest status reports for the account

NONE
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
required

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
optional

< JobDeleteReport > array

ExampleHTTP response

Response 200

JSON
{
   "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
      }
   ]
}

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.