{"_id":"5c8a617d22ea4b0024697106","project":"55faf11ba62ba1170021a9a7","version":{"_id":"55faf11ba62ba1170021a9aa","project":"55faf11ba62ba1170021a9a7","__v":46,"createdAt":"2015-09-17T16:58:03.490Z","releaseDate":"2015-09-17T16:58:03.490Z","categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77","59a555bccdbd85001bfb1442","5a2a81f688574d001e9934f5","5b080c8d7833b20003ddbb6f","5c222bed4bc358002f21459a","5c22412594a2a5005cc9e919","5c41ae1c33592700190a291e","5c8a525e2ba7b2003f9b153c","5cbf14d58c79c700ef2b502e","5db6f03a6e187c006f667fa4"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"5c8a525e2ba7b2003f9b153c","project":"55faf11ba62ba1170021a9a7","version":"55faf11ba62ba1170021a9aa","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2019-03-14T13:08:46.350Z","from_sync":false,"order":37,"slug":"async-bulk-actions","title":"ASYNC BULK ACTIONS"},"user":"566590c83889610d0008a253","__v":0,"parentDoc":null,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-03-14T14:13:17.058Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":4,"body":"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.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Request\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://cgc-api.sbgenomics.com/v2/async/files/delete/{jobid}\",\n      \"language\": \"text\",\n      \"name\": \"Path\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Example request\",\n  \"sidebar\": true\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"GET /v2/async/files/delete/70721895322947584\\nHost: cgc-api.sbgenomics.com\\nX-SBG-Auth-Token: 3259c50e1ac5336ea8f1253259740f75\",\n      \"language\": \"http\",\n      \"name\": null\n    },\n    {\n      \"code\": \"curl -X GET \\\\\\n  https://cgc-api.sbgenomics.com/v2/async/files/delete/70796015691698176 \\\\\\n  -H 'Content-Type: application/json' \\\\\\n  -H 'X-SBG-Auth-Token: d32c2976ffc04d0eb90c6c4fb4c0a465' \\\\\",\n      \"language\": \"curl\",\n      \"name\": \"cURL\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]\n###Header Fields\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"`X-SBG-Auth-Token`\\n*required*\",\n    \"0-1\": \"Your CGC [authentication token](doc:get-your-authentication-token).\",\n    \"h-2\": \"\",\n    \"1-0\": \"`Content-Type`\\n*required*\",\n    \"1-1\": \"`application/json`\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\n### Query parameters\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Key\",\n    \"h-1\": \"Data type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"`ID`\\n_required_\",\n    \"0-1\": \"string\",\n    \"0-2\": \"The ID of the deletion job you are querying. This ID can be found within the API response for the call for deleting files.\"\n  },\n  \"cols\": 3,\n  \"rows\": 1\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Response\"\n}\n[/block]\n[See a list of CGC-specific response codes that may be contained in the body of the response.](ref:api-status-codes)\n\n## Response body\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"`id`\",\n    \"h-0\": \"Key\",\n    \"h-1\": \"Data type\",\n    \"h-2\": \"Description\",\n    \"0-1\": \"string\",\n    \"0-2\": \"ID of this delete job.\",\n    \"1-0\": \"`result`\",\n    \"1-1\": \"string\",\n    \"1-2\": \"The result of the delete job.\",\n    \"2-0\": \"`type`\",\n    \"2-1\": \"string\",\n    \"2-2\": \"The type of job which is DELETE.\",\n    \"3-0\": \"`state`\",\n    \"3-1\": \"string\",\n    \"3-2\": \"The following states are available:\\n\\nSUBMITTED\\nRESOLVING\\nRUNNING\\nFINISHED\",\n    \"4-0\": \"`failed_files`\",\n    \"5-0\": \"`completed_files`\",\n    \"6-0\": \"`total_files`\",\n    \"7-0\": \"`started_on`\",\n    \"8-0\": \"`finished_on`\",\n    \"4-1\": \"string\",\n    \"5-1\": \"string\",\n    \"6-1\": \"string\",\n    \"7-1\": \"string\",\n    \"8-1\": \"string\",\n    \"4-2\": \"The number of files that failed to delete.\",\n    \"5-2\": \"The number of files that were successfully deleted.\",\n    \"6-2\": \"The total number of files that were processed for the job.\",\n    \"7-2\": \"The time and date the deletion job started.\",\n    \"8-2\": \"The time and date the deletion job has finished.\"\n  },\n  \"cols\": 3,\n  \"rows\": 9\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Example response body\",\n  \"sidebar\": true\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"\\n{\\n    \\\"href\\\": \\\"https://cgc-api.sbgenomics.com/v2/async/files/delete/70803031344615424\\\",\\n    \\\"id\\\": \\\"70803031344615424\\\",\\n    \\\"result\\\": [\\n        {\\n            \\\"resource\\\": {\\n                \\\"href\\\": \\\"https://cgc-api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d309\\\",\\n                \\\"id\\\": \\\"5c6e7e36e4b038560025d309\\\"\\n            }\\n        },\\n        {\\n            \\\"resource\\\": {\\n                \\\"href\\\": \\\"https://cgc-api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d30b\\\",\\n                \\\"id\\\": \\\"5c6e7e36e4b038560025d30b\\\"\\n            }\\n        },\\n        {\\n            \\\"resource\\\": {\\n                \\\"href\\\": \\\"https://cgc-api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d30b\\\",\\n                \\\"id\\\": \\\"5c6d3f30e4b0385632389331\\\"\\n            }\\n        }\\n        }\\n    ],\\n    \\\"type\\\": \\\"DELETE\\\",\\n    \\\"state\\\": \\\"FINISHED\\\",\\n    \\\"failed_files\\\": 0,\\n    \\\"completed_files\\\": 3,\\n    \\\"total_files\\\": 3,\\n    \\\"started_on\\\": \\\"2019-02-21T12:23:52Z\\\",\\n    \\\"finished_on\\\": \\\"2019-02-21T12:23:52Z\\\"\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Example response body\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"v2/async/files/delete/{jobid}","slug":"get-details-of-a-deletion-job","type":"basic","title":"Get details of a deletion job"}

GET STARTED

TUTORIALS

ACCESS THE CGC

MANAGE AN ANALYSIS ENVIRONMENT

COLLABORATE SECURELY

DATASETS HUB

PUBLIC PROJECTS

BRING DATA TO THE CGC

SET METADATA ASSOCIATED WITH A PRIVATE FILE

SEARCH FILES

ADD FILES TO A PROJECT

ORGANIZE FILES

ARCHIVE FILES

FIND APPS

RABIX OVERVIEW

DOCKER

DESCRIBE YOUR TOOL (LEGACY)

TOOL WRAPPING TIPS AND TRICKS

EDIT AN APP (LEGACY)

ARCHIVE APPS

RUN AN ANALYSIS

TASK EXECUTION

REVIEW A TASK

VIEW ANALYSIS RESULTS

INTERACTIVE ANALYSIS

DOWNLOAD RESULTS

DEVELOPER TOOLS

CONNECT CLOUD STORAGE

API Hub

API CLIENTS

SB Command Line Interface

API Reference

EDIT AN APP

BULK API ACTIONS

ASYNC BULK ACTIONS

DRS API

WATCH AND LEARN

DATA CRUNCHER

SBFS (Beta)

SBFS Command Reference

Get details of a deletion job

v2/async/files/delete/{jobid}
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. [block:api-header] { "type": "basic", "title": "Request" } [/block] [block:code] { "codes": [ { "code": "https://cgc-api.sbgenomics.com/v2/async/files/delete/{jobid}", "language": "text", "name": "Path" } ] } [/block] [block:api-header] { "type": "basic", "title": "Example request", "sidebar": true } [/block] [block:code] { "codes": [ { "code": "GET /v2/async/files/delete/70721895322947584\nHost: cgc-api.sbgenomics.com\nX-SBG-Auth-Token: 3259c50e1ac5336ea8f1253259740f75", "language": "http", "name": null }, { "code": "curl -X GET \\\n https://cgc-api.sbgenomics.com/v2/async/files/delete/70796015691698176 \\\n -H 'Content-Type: application/json' \\\n -H 'X-SBG-Auth-Token: d32c2976ffc04d0eb90c6c4fb4c0a465' \\", "language": "curl", "name": "cURL" } ], "sidebar": true } [/block] ###Header Fields [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "`X-SBG-Auth-Token`\n*required*", "0-1": "Your CGC [authentication token](doc:get-your-authentication-token).", "h-2": "", "1-0": "`Content-Type`\n*required*", "1-1": "`application/json`" }, "cols": 2, "rows": 2 } [/block] ### Query parameters [block:parameters] { "data": { "h-0": "Key", "h-1": "Data type", "h-2": "Description", "0-0": "`ID`\n_required_", "0-1": "string", "0-2": "The ID of the deletion job you are querying. This ID can be found within the API response for the call for deleting files." }, "cols": 3, "rows": 1 } [/block] [block:api-header] { "type": "basic", "title": "Response" } [/block] [See a list of CGC-specific response codes that may be contained in the body of the response.](ref:api-status-codes) ## Response body [block:parameters] { "data": { "0-0": "`id`", "h-0": "Key", "h-1": "Data type", "h-2": "Description", "0-1": "string", "0-2": "ID of this delete job.", "1-0": "`result`", "1-1": "string", "1-2": "The result of the delete job.", "2-0": "`type`", "2-1": "string", "2-2": "The type of job which is DELETE.", "3-0": "`state`", "3-1": "string", "3-2": "The following states are available:\n\nSUBMITTED\nRESOLVING\nRUNNING\nFINISHED", "4-0": "`failed_files`", "5-0": "`completed_files`", "6-0": "`total_files`", "7-0": "`started_on`", "8-0": "`finished_on`", "4-1": "string", "5-1": "string", "6-1": "string", "7-1": "string", "8-1": "string", "4-2": "The number of files that failed to delete.", "5-2": "The number of files that were successfully deleted.", "6-2": "The total number of files that were processed for the job.", "7-2": "The time and date the deletion job started.", "8-2": "The time and date the deletion job has finished." }, "cols": 3, "rows": 9 } [/block] [block:api-header] { "type": "basic", "title": "Example response body", "sidebar": true } [/block] [block:code] { "codes": [ { "code": "\n{\n \"href\": \"https://cgc-api.sbgenomics.com/v2/async/files/delete/70803031344615424\",\n \"id\": \"70803031344615424\",\n \"result\": [\n {\n \"resource\": {\n \"href\": \"https://cgc-api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d309\",\n \"id\": \"5c6e7e36e4b038560025d309\"\n }\n },\n {\n \"resource\": {\n \"href\": \"https://cgc-api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d30b\",\n \"id\": \"5c6e7e36e4b038560025d30b\"\n }\n },\n {\n \"resource\": {\n \"href\": \"https://cgc-api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d30b\",\n \"id\": \"5c6d3f30e4b0385632389331\"\n }\n }\n }\n ],\n \"type\": \"DELETE\",\n \"state\": \"FINISHED\",\n \"failed_files\": 0,\n \"completed_files\": 3,\n \"total_files\": 3,\n \"started_on\": \"2019-02-21T12:23:52Z\",\n \"finished_on\": \"2019-02-21T12:23:52Z\"\n}", "language": "json", "name": "Example response body" } ], "sidebar": true } [/block]