Batch file delete

DEL

Used to delete multiple files in one go. Up to 100 files are supported per request. A JSON object holding your File list SHOULD be put into a request body.

Note: this operation removes files from storage but doesn’t invalidate CDN cache.

Headers

AcceptstringOptional

Version header.

Request

This endpoint expects a list of strings.

Response

This endpoint returns an object.

statusstringOptional

problemsmap from strings to anyOptional

Dictionary of passed files UUIDs and problems associated with these UUIDs.

resultlist of objectsOptional

List of file objects that have been stored/deleted.

Errors

DEL

1 curl -X DELETE https://api.uploadcare.com/files/storage/ \
2      -H "Accept: application/vnd.uploadcare-v0.7+json" \
3      -H "Authorization: <apiKey>" \
4      -H "Content-Type: application/json" \
5      -d '[
6   "21975c81-7f57-4c7a-aef9-acfe28779f78",
7   "cbaf2d73-5169-4b2b-a543-496cf2813dff"
8 ]'

1 {
2   "status": "ok",
3   "problems": {
4     "21975c81-7f57-4c7a-aef9-acfe28779f78": "Missing in the project",
5     "4j334o01-8bs3": "Invalid"
6   },
7   "result": [
8     {
9       "datetime_removed": "2024-01-15T09:30:00Z",
10       "datetime_stored": "2018-11-26T12:49:10Z",
11       "datetime_uploaded": "2018-11-26T12:49:09Z",
12       "is_image": true,
13       "is_ready": true,
14       "mime_type": "image/jpeg",
15       "original_file_url": "https://ucarecdn.com/22240276-2f06-41f8-9411-755c8ce926ed/pineapple.jpg",
16       "original_filename": "pineapple.jpg",
17       "size": 642,
18       "url": "https://api.uploadcare.com/files/22240276-2f06-41f8-9411-755c8ce926ed/",
19       "uuid": "22240276-2f06-41f8-9411-755c8ce926ed",
20       "appdata": {
21         "aws_rekognition_detect_labels": {
22           "version": "2016-06-27",
23           "datetime_created": "2021-09-21T11:25:31Z",
24           "datetime_updated": "2021-09-21T11:27:33Z",
25           "data": {
26             "LabelModelVersion": "2.0",
27             "Labels": [
28               {
29                 "Confidence": 93.41645812988281,
30                 "Instances": [
31                   {}
32                 ],
33                 "Name": "Home Decor",
34                 "Parents": [
35                   {}
36                 ]
37               },
38               {
39                 "Confidence": 70.75951385498047,
40                 "Instances": [
41                   {}
42                 ],
43                 "Name": "Linen",
44                 "Parents": [
45                   {
46                     "Name": "Home Decor"
47                   }
48                 ]
49               },
50               {
51                 "Confidence": 64.7123794555664,
52                 "Instances": [
53                   {}
54                 ],
55                 "Name": "Sunlight",
56                 "Parents": [
57                   {}
58                 ]
59               },
60               {
61                 "Confidence": 56.264793395996094,
62                 "Instances": [
63                   {}
64                 ],
65                 "Name": "Flare",
66                 "Parents": [
67                   {
68                     "Name": "Light"
69                   }
70                 ]
71               },
72               {
73                 "Confidence": 50.47153854370117,
74                 "Instances": [
75                   {}
76                 ],
77                 "Name": "Tree",
78                 "Parents": [
79                   {
80                     "Name": "Plant"
81                   }
82                 ]
83               }
84             ]
85           }
86         },
87         "aws_rekognition_detect_moderation_labels": {
88           "version": "2016-06-27",
89           "datetime_created": "2023-02-21T11:25:31Z",
90           "datetime_updated": "2023-02-21T11:27:33Z",
91           "data": {
92             "ModerationModelVersion": "6.0",
93             "ModerationLabels": [
94               {
95                 "Confidence": 93.41645812988281,
96                 "Name": "Weapons",
97                 "ParentName": "Violence"
98               }
99             ]
100           }
101         },
102         "remove_bg": {
103           "version": "1.0",
104           "datetime_created": "2021-07-25T12:24:33Z",
105           "datetime_updated": "2021-07-25T12:24:33Z",
106           "data": {
107             "foreground_type": "person"
108           }
109         },
110         "uc_clamav_virus_scan": {
111           "version": "0.104.2",
112           "datetime_created": "2021-09-21T11:24:33Z",
113           "datetime_updated": "2021-09-21T11:24:33Z",
114           "data": {
115             "infected": true,
116             "infected_with": "Win.Test.EICAR_HDB-1"
117           }
118         }
119       },
120       "variations": {
121         "key": "value"
122       },
123       "content_info": {
124         "mime": {
125           "mime": "image/jpeg",
126           "type": "image",
127           "subtype": "jpeg"
128         },
129         "image": {
130           "color_mode": "RGB",
131           "orientation": 6,
132           "format": "JPEG",
133           "sequence": false,
134           "height": 500,
135           "width": 500,
136           "geo_location": {
137             "latitude": 55.62013611111111,
138             "longitude": 37.66299166666666
139           },
140           "datetime_original": "2018-08-20T08:59:50Z",
141           "dpi": [
142             72,
143             72
144           ]
145         },
146         "video": {
147           "duration": 261827,
148           "format": "mp4",
149           "bitrate": 393,
150           "audio": [
151             {
152               "bitrate": 78,
153               "codec": "aac",
154               "sample_rate": 44100,
155               "channels": 2
156             }
157           ],
158           "video": [
159             {
160               "height": 360,
161               "width": 640,
162               "frame_rate": 30,
163               "bitrate": 315,
164               "codec": "h264"
165             }
166           ]
167         }
168       },
169       "metadata": {
170         "subsystem": "uploader",
171         "pet": "cat"
172       }
173     }
174   ]
175 }

Built with

1	curl -X DELETE https://api.uploadcare.com/files/storage/ \
2	-H "Accept: application/vnd.uploadcare-v0.7+json" \
3	-H "Authorization: <apiKey>" \
4	-H "Content-Type: application/json" \
5	-d '[
6	"21975c81-7f57-4c7a-aef9-acfe28779f78",
7	"cbaf2d73-5169-4b2b-a543-496cf2813dff"
8	]'

1	{
2	"status": "ok",
3	"problems": {
4	"21975c81-7f57-4c7a-aef9-acfe28779f78": "Missing in the project",
5	"4j334o01-8bs3": "Invalid"
6	},
7	"result": [
8	{
9	"datetime_removed": "2024-01-15T09:30:00Z",
10	"datetime_stored": "2018-11-26T12:49:10Z",
11	"datetime_uploaded": "2018-11-26T12:49:09Z",
12	"is_image": true,
13	"is_ready": true,
14	"mime_type": "image/jpeg",
15	"original_file_url": "https://ucarecdn.com/22240276-2f06-41f8-9411-755c8ce926ed/pineapple.jpg",
16	"original_filename": "pineapple.jpg",
17	"size": 642,
18	"url": "https://api.uploadcare.com/files/22240276-2f06-41f8-9411-755c8ce926ed/",
19	"uuid": "22240276-2f06-41f8-9411-755c8ce926ed",
20	"appdata": {
21	"aws_rekognition_detect_labels": {
22	"version": "2016-06-27",
23	"datetime_created": "2021-09-21T11:25:31Z",
24	"datetime_updated": "2021-09-21T11:27:33Z",
25	"data": {
26	"LabelModelVersion": "2.0",
27	"Labels": [
28	{
29	"Confidence": 93.41645812988281,
30	"Instances": [
31	{}
32	],
33	"Name": "Home Decor",
34	"Parents": [
35	{}
36	]
37	},
38	{
39	"Confidence": 70.75951385498047,
40	"Instances": [
41	{}
42	],
43	"Name": "Linen",
44	"Parents": [
45	{
46	"Name": "Home Decor"
47	}
48	]
49	},
50	{
51	"Confidence": 64.7123794555664,
52	"Instances": [
53	{}
54	],
55	"Name": "Sunlight",
56	"Parents": [
57	{}
58	]
59	},
60	{
61	"Confidence": 56.264793395996094,
62	"Instances": [
63	{}
64	],
65	"Name": "Flare",
66	"Parents": [
67	{
68	"Name": "Light"
69	}
70	]
71	},
72	{
73	"Confidence": 50.47153854370117,
74	"Instances": [
75	{}
76	],
77	"Name": "Tree",
78	"Parents": [
79	{
80	"Name": "Plant"
81	}
82	]
83	}
84	]
85	}
86	},
87	"aws_rekognition_detect_moderation_labels": {
88	"version": "2016-06-27",
89	"datetime_created": "2023-02-21T11:25:31Z",
90	"datetime_updated": "2023-02-21T11:27:33Z",
91	"data": {
92	"ModerationModelVersion": "6.0",
93	"ModerationLabels": [
94	{
95	"Confidence": 93.41645812988281,
96	"Name": "Weapons",
97	"ParentName": "Violence"
98	}
99	]
100	}
101	},
102	"remove_bg": {
103	"version": "1.0",
104	"datetime_created": "2021-07-25T12:24:33Z",
105	"datetime_updated": "2021-07-25T12:24:33Z",
106	"data": {
107	"foreground_type": "person"
108	}
109	},
110	"uc_clamav_virus_scan": {
111	"version": "0.104.2",
112	"datetime_created": "2021-09-21T11:24:33Z",
113	"datetime_updated": "2021-09-21T11:24:33Z",
114	"data": {
115	"infected": true,
116	"infected_with": "Win.Test.EICAR_HDB-1"
117	}
118	}
119	},
120	"variations": {
121	"key": "value"
122	},
123	"content_info": {
124	"mime": {
125	"mime": "image/jpeg",
126	"type": "image",
127	"subtype": "jpeg"
128	},
129	"image": {
130	"color_mode": "RGB",
131	"orientation": 6,
132	"format": "JPEG",
133	"sequence": false,
134	"height": 500,
135	"width": 500,
136	"geo_location": {
137	"latitude": 55.62013611111111,
138	"longitude": 37.66299166666666
139	},
140	"datetime_original": "2018-08-20T08:59:50Z",
141	"dpi": [
142	72,
143	72
144	]
145	},
146	"video": {
147	"duration": 261827,
148	"format": "mp4",
149	"bitrate": 393,
150	"audio": [
151	{
152	"bitrate": 78,
153	"codec": "aac",
154	"sample_rate": 44100,
155	"channels": 2
156	}
157	],
158	"video": [
159	{
160	"height": 360,
161	"width": 640,
162	"frame_rate": 30,
163	"bitrate": 315,
164	"codec": "h264"
165	}
166	]
167	}
168	},
169	"metadata": {
170	"subsystem": "uploader",
171	"pet": "cat"
172	}
173	}
174	]
175	}