The Delete Task Files deletes files generated by the export service that are stored in a Reltio bucket. If the task is part of a group, the API deletes files for all tasks in the group. If the files are stored in a custom destination, the API does not delete them and returns an error. For Reltio bucket paths and custom destinations, see Store export results. To delete files for a specific tenant, see Delete Task Files for Tenant API.

The following role can delete the result files:

• System Administrator

HTTP method and endpoint

Use the following HTTP method and endpoint path to submit the request for deleting result files of an export task.

DELETE {ExportServiceURL}/tasks/{taskId}/_files

Replace {ExportServiceURL} with the Export Service URL for your environment, for example, http://example.reltio.com/jobs.

The following table describes the endpoint path parameters.

Request headers

The following request headers must be included.

Request body

This operation does not require a request body.

Example request

Use the following example to see how a complete request is structured with headers to delete result files.

DELETE {ExportServiceURL}/tasks/{taskId}/_files

Response body

The following table describes the fields returned in the response body.

Example response

The following example shows a response with a successful delete.

{
    "status": "success"
}

Additional examples

The following table lists additional sample requests and responses.

DELETE {ExportServiceURL}/tasks/{taskId}/_files

{"status": "success"}

DELETE {ExportServiceURL}/tasks/{taskId}/_files

{"status": "success"}

DELETE {ExportServiceURL}/tasks/{taskId}/_files

{"severity": "Error", "errorMessage": "Operation not permitted", "errorCode": 565, "errorDetailMessage": "Files exported to a custom destination cannot be deleted"}

DELETE {ExportServiceURL}/tasks/{taskId}/_files

{"severity": "Error", "errorMessage": "Object with id={taskId} not found", "errorCode": 101, "errorDetailMessage": "No object with specified id found"}

DELETE {ExportServiceURL}/tasks/{taskId}/_files

{"severity": "Error", "errorMessage": "This operation can not be done with task in PROCESSING state.", "errorCode": 437, "errorDetailMessage": "This operation can not be done with task in PROCESSING state."}

DELETE {ExportServiceURL}/tasks/{taskId}/_files

{"severity": "Error", "errorMessage": "This operation can not be done with task in PAUSED state.", "errorCode": 437, "errorDetailMessage": "This operation can not be done with task in PAUSED state."}

Error codes and recommended actions

The following table lists the possible error responses returned by this API.