{"_id":"5c8a6a306aab9700bf1e7ec1","project":"5773dcfc255e820e00e1cd4d","version":{"_id":"5773dcfc255e820e00e1cd50","__v":26,"project":"5773dcfc255e820e00e1cd4d","createdAt":"2016-06-29T14:36:44.812Z","releaseDate":"2016-06-29T14:36:44.812Z","categories":["5773dcfc255e820e00e1cd51","5773df36904b0c0e00ef05ff","577baf92451b1e0e006075ac","577bb183b7ee4a0e007c4e8d","577ce77a1cf3cb0e0048e5ea","577d11865fd4de0e00cc3dab","578e62792c3c790e00937597","578f4fd98335ca0e006d5c84","578f5e5c3d04570e00976ebb","57bc35f7531e000e0075d118","57f801b3760f3a1700219ebb","5804d55d1642890f00803623","581c8d55c0dc651900aa9350","589dcf8ba8c63b3b00c3704f","594cebadd8a2f7001b0b53b2","59a562f46a5d8c00238e309a","5a2aa096e25025003c582b58","5a2e79566c771d003ca0acd4","5a3a5166142db90026f24007","5a3a52b5bcc254001c4bf152","5a3a574a2be213002675c6d2","5a3a66bb2be213002675cb73","5a3a6e4854faf60030b63159","5c8a68278e883901341de571","5cb9971e57bf020024523c7b","5cbf1683e2a36d01d5012ecd"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"5c8a68278e883901341de571","project":"5773dcfc255e820e00e1cd4d","version":"5773dcfc255e820e00e1cd50","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2019-03-14T14:41:43.757Z","from_sync":false,"order":16,"slug":"async-bulk-actions","title":"ASYNC BULK ACTIONS"},"user":"566590c83889610d0008a253","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-03-14T14:50:24.700Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"This call lets you perform perform an asynchronous bulk deletion of files or folders. Deleting folders which aren't empty is allowed. \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://cavatica-api.sbgenomics.com/v2/async/files/delete\\n\",\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\": \"POST /v2/async/files/delete\\nHost: cavatica-api.sbgenomics.com\\nX-SBG-Auth-Token: 3259c50e1ac5336ea8f1273259740f75\",\n      \"language\": \"http\",\n      \"name\": null\n    },\n    {\n      \"code\": \"curl -X POST \\\\\\n  https://cavatica-api.sbgenomics.com/v2/async/files/delete \\\\\\n  -H 'Content-Type: application/json' \\\\\\n  -H 'X-SBG-Auth-Token: d32c2976ffc04d0eb90c6c4fb2c0a465' \\\\\\n  -d '{\\n  \\\"items\\\": [\\n    {\\n      \\\"file\\\": \\\"5c6d3f30e4b038563238932f\\\"\\n    },\\n    {\\n      \\\"file\\\": \\\"5c6d3f30e4b038563238932b\\\"\\n     },\\n    {\\n      \\\"file\\\": \\\"5c6d3f30e4b0385632389331\\\"\\n    }\\n  ]\\n}'\",\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 Cavatica [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###Request body\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Key\",\n    \"h-1\": \"Data type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"`file`\\nrequired\",\n    \"0-1\": \"object\",\n    \"0-2\": \"The ID of the file or folder you are deleting. Use the API call for listing all files to obtain the file or folder ID. Deleting folders which are not empty is allowed.\"\n  },\n  \"cols\": 3,\n  \"rows\": 1\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"items\\\": [\\n    {\\n      \\\"file\\\": \\\"5c6d3f30e4b038563238932f\\\"\\n    },\\n    {\\n      \\\"file\\\": \\\"5c6d3f30e4b038563238932b\\\"\\n     },\\n    {\\n      \\\"file\\\": \\\"5c6d3f30e4b0385632389331\\\"\\n    }\\n  ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Example request body\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Response\"\n}\n[/block]\n[See a list of Cavatica-specific response codes that may be contained in the body of the response.](ref:api-status-codes).\n[block:api-header]\n{\n  \"title\": \"Response body\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Key\",\n    \"h-1\": \"Data type of value\",\n    \"h-2\": \"Description of value\",\n    \"0-0\": \"`file`\",\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 job if available at the time the call is made. Use the details of a deletion job to see more information.\",\n    \"2-0\": \"`type`\",\n    \"2-1\": \"string\",\n    \"2-2\": \"The type of job, which is `DELETE` in the case of deleting files.\",\n    \"3-0\": \"`state`\",\n    \"3-1\": \"string\",\n    \"3-2\": \"The state is SUBMITTED at the time of making this call.\",\n    \"4-0\": \"`failed_files`\",\n    \"4-1\": \"string\",\n    \"4-2\": \"The number of failed files if that information is available at the time of the call. You can get details of a copy job with a dedicated call.\",\n    \"5-0\": \"`completed_files`\",\n    \"5-1\": \"string\",\n    \"5-2\": \"The number of completed files if that information is available at the time of the call. You can get details of a copy job with a dedicated call.\",\n    \"6-0\": \"`total_files`\",\n    \"6-1\": \"string\",\n    \"6-2\": \"The number of failed files if that information is available at the time of the call. You can get the details of a deletion job with a dedicated call.\"\n  },\n  \"cols\": 3,\n  \"rows\": 7\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    \\\"href\\\": \\\"https://cavatica-api.sbgenomics.com/v2/async/files/delete/70714077692891136\\\",\\n    \\\"id\\\": \\\"70714077692891136\\\",\\n    \\\"result\\\": [],\\n    \\\"type\\\": \\\"DELETE\\\",\\n    \\\"state\\\": \\\"SUBMITTED\\\",\\n    \\\"failed_files\\\": 0,\\n    \\\"completed_files\\\": 0,\\n    \\\"total_files\\\": 0\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Example response body\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"v2/async/files/delete","slug":"delete-multiple-files-and-folders","type":"basic","title":"Delete multiple files and folders"}

Delete multiple files and folders

v2/async/files/delete

This call lets you perform perform an asynchronous bulk deletion of files or folders. Deleting folders which aren't empty is allowed. [block:api-header] { "type": "basic", "title": "Request" } [/block] [block:code] { "codes": [ { "code": "https://cavatica-api.sbgenomics.com/v2/async/files/delete\n", "language": "text", "name": "Path" } ] } [/block] [block:api-header] { "type": "basic", "title": "Example request", "sidebar": true } [/block] [block:code] { "codes": [ { "code": "POST /v2/async/files/delete\nHost: cavatica-api.sbgenomics.com\nX-SBG-Auth-Token: 3259c50e1ac5336ea8f1273259740f75", "language": "http", "name": null }, { "code": "curl -X POST \\\n https://cavatica-api.sbgenomics.com/v2/async/files/delete \\\n -H 'Content-Type: application/json' \\\n -H 'X-SBG-Auth-Token: d32c2976ffc04d0eb90c6c4fb2c0a465' \\\n -d '{\n \"items\": [\n {\n \"file\": \"5c6d3f30e4b038563238932f\"\n },\n {\n \"file\": \"5c6d3f30e4b038563238932b\"\n },\n {\n \"file\": \"5c6d3f30e4b0385632389331\"\n }\n ]\n}'", "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 Cavatica [authentication token](doc:get-your-authentication-token).", "h-2": "", "1-0": " Content-Type\n*required* ", "1-1": "`application/json`" }, "cols": 2, "rows": 2 } [/block] ###Request body [block:parameters] { "data": { "h-0": "Key", "h-1": "Data type", "h-2": "Description", "0-0": "`file`\nrequired", "0-1": "object", "0-2": "The ID of the file or folder you are deleting. Use the API call for listing all files to obtain the file or folder ID. Deleting folders which are not empty is allowed." }, "cols": 3, "rows": 1 } [/block] [block:code] { "codes": [ { "code": "{\n \"items\": [\n {\n \"file\": \"5c6d3f30e4b038563238932f\"\n },\n {\n \"file\": \"5c6d3f30e4b038563238932b\"\n },\n {\n \"file\": \"5c6d3f30e4b0385632389331\"\n }\n ]\n}", "language": "json", "name": "Example request body" } ] } [/block] [block:api-header] { "type": "basic", "title": "Response" } [/block] [See a list of Cavatica-specific response codes that may be contained in the body of the response.](ref:api-status-codes). [block:api-header] { "title": "Response body" } [/block] [block:parameters] { "data": { "h-0": "Key", "h-1": "Data type of value", "h-2": "Description of value", "0-0": "`file`", "0-1": "string", "0-2": "ID of this delete job.", "1-0": "`result`", "1-1": "string", "1-2": "The result of the job if available at the time the call is made. Use the details of a deletion job to see more information.", "2-0": "`type`", "2-1": "string", "2-2": "The type of job, which is `DELETE` in the case of deleting files.", "3-0": "`state`", "3-1": "string", "3-2": "The state is SUBMITTED at the time of making this call.", "4-0": "`failed_files`", "4-1": "string", "4-2": "The number of failed files if that information is available at the time of the call. You can get details of a copy job with a dedicated call.", "5-0": "`completed_files`", "5-1": "string", "5-2": "The number of completed files if that information is available at the time of the call. You can get details of a copy job with a dedicated call.", "6-0": "`total_files`", "6-1": "string", "6-2": "The number of failed files if that information is available at the time of the call. You can get the details of a deletion job with a dedicated call." }, "cols": 3, "rows": 7 } [/block] [block:api-header] { "type": "basic", "title": "Example response body", "sidebar": true } [/block] [block:code] { "codes": [ { "code": "{\n \"href\": \"https://cavatica-api.sbgenomics.com/v2/async/files/delete/70714077692891136\",\n \"id\": \"70714077692891136\",\n \"result\": [],\n \"type\": \"DELETE\",\n \"state\": \"SUBMITTED\",\n \"failed_files\": 0,\n \"completed_files\": 0,\n \"total_files\": 0\n}", "language": "json", "name": "Example response body" } ], "sidebar": true } [/block]