This call gets the details of an asynchronous bulk deletion job. This information will be available for up to a month after the job has been completed.

Request

https://api.sbgenomics.com/v2/async/files/delete/{jobid}

https://eu-api.sbgenomics.com/v2/async/files/delete/{jobid}

Example request

GET /v2/async/files/delete/70721895322947584
Host: api.sbgenomics.com
X-SBG-Auth-Token: 3259c50e1ac5336ea8f1253259740f75

curl -X GET \
  https://api.sbgenomics.com/v2/async/files/delete/70721895322947584 \
  -H 'Content-Type: application/json' \
  -H 'X-SBG-Auth-Token: d32c2976ffc04d0eb90c6c4fb4c0a465' \

from time import sleep
from sevenbridges import Api, AsyncJobStates

api = Api(url='https://api.sbgenomics.com/v2',
          token='3259c50e1ac5426ea8f1273259740f74')

# send GET request to SB API
async_job = api.async_jobs.get_file_delete_job(id='70721895322947584')

print(async_job.id, async_job.type, async_job.state)
# wait for async job to finish
while async_job.state != AsyncJobStates.FINISHED:
    async_job.reload()
    sleep(secs=60)
file_delete_records = async_job.get_result()
for file_delete_record in file_delete_records:
    if file_delete_record.valid:
        file = file_delete_record.resource
        print(file.id)  # only file ID will be available
    else:
        print(file_delete_record.error)

Header Fields

Name	Description
`X-SBG-Auth-Token` required	Your Seven Bridges Platform authentication token.
`Content-Type` required	`application/json`

Query parameters

Key	Data type	Description
`ID` required	string	The ID of the deletion job you are querying. This ID can be found within the API response for the call for deleting files.

Response

See a list of Seven Bridges Platform-specific response codes that may be contained in the body of the response.

Response body

Key	Data type	Description
`id`	string	ID of this delete job.
`result`	string	The result of the delete job.
`type`	string	The type of job which is DELETE.
`state`	string	The following states are available: SUBMITTED RESOLVING RUNNING FINISHED
`failed_files`	string	The number of files that failed to delete.
`completed_files`	string	The number of files that were successfully deleted.
`total_files`	string	The total number of files that were processed for the job.
`started_on`	string	The time and date the deletion job started.
`finished_on`	string	The time and date the deletion job has finished.

Example response body

{
    "href": "https://api.sbgenomics.com/v2/async/files/delete/70721895322947584",
    "id": "70721895322947584",
    "result": [
        {
            "resource": {
                "href": "https://api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d309",
                "id": "5c6e7e36e4b038560025d309"
            }
        },
        {
            "resource": {
                "href": "https://api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d30b",
                "id": "5c6e7e36e4b038560025d30b"
            }
        },
        {
            "resource": {
                "href": "https://api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d30b",
                "id": "5c6d3f30e4b0385632389331"
            }
        }
        }
    ],
    "type": "DELETE",
    "state": "FINISHED",
    "failed_files": 0,
    "completed_files": 3,
    "total_files": 3,
    "started_on": "2019-02-21T12:23:52Z",
    "finished_on": "2019-02-21T12:23:52Z"
}