Delete downloaded file task (Sandbox)
Expand all | Collapse all
The /sandbox/tasks/file_from_url/{task ID} endpoint is used to delete a file execution task in Kaspersky Sandbox.
Request
Request method: DELETE
Endpoint: https://tip.kaspersky.com/api/sandbox/tasks/file_from_url/{task_id}
Query parameters:
Expected parameters
Parameter
|
Description
|
task_id
|
Object execution task ID.
|
Response example:
To delete a task: for a downloaded and executed file:
curl -u <user name> --cert <full path to the certificate on your computer> -X DELETE 'https://tip.kaspersky.com/api/sandbox/tasks/file_from_url/<task ID>'
|
Responses
200 OK
Request processed successfully.
Endpoint deletes the specified task.
400 Bad Request
Request not processed: incorrect query.
Make sure you enter the correct task ID and parameters, and then try to run the query again.
The following data is returned:
error—Error ID.Available values:
invalid-params—Invalid parameter value.too-large-file—Failed to execute the object because it exceeds a size limit.
description—Error description.
Response sample
{
"error": "invalid-params",
"description": "error description"
}
401 Unauthorized
Request not processed: user authentication failed.
Make sure you enter the correct credentials, and then try to run the query again. If the problem recurs, please contact your dedicated Kaspersky Technical Account Manager.
403 Forbidden
Request not processed: running requests by using an API token is forbidden for this service.
You can use an API token only for running Threat Lookup API requests.
For other Kaspersky Threat Intelligence Portal services, a certificate is required, an API token usage is not available.
404 Not Found
Specified task failed or hung.
Run the query again later.
451 Unavailable For Legal Reasons
Page top