---
title: "Bulk delete files"
method: POST
path: "/files/delete"
tags: ["Files"]
---

# Bulk delete files

`POST /files/delete`

Delete one or more files at once.

## Request body

- object
  - `file_ids` string[], required — The IDs of the files to delete. This operational is “all or nothing” — meaning all the file IDs must be valid and successfully deleted or none of the files specified by the file IDs are deleted.

## Response `200`

Success. All files specified by the file IDs were deleted.

- FileDeletedBulk
  - `success` boolean — Indicates whether the bulk delete was successful. Returns `true` if the all files were successfully deleted, otherwise returns `false`.
  - `error_file_ids` string[] — An array of file IDs that could not be deleted. This array will not be returned if all files were successfully deleted.

## Other responses

- `4XX` — Client error <p> This indicates an issue with the request format or frequency. Please see our [Error Codes](https://docs.voyageai.com/docs/error-codes) guide. </p>
- `5XX` — Server Error <p> This indicates our servers are experiencing high traffic or having an unexpected issue. Please see our [Error Codes](https://docs.voyageai.com/docs/error-codes) guide. </p>

---

[API](https://skmtc.net/voyageai/apis/voyage-api.md) · [All operations](https://skmtc.net/voyageai/apis/voyage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voyageai/voyage-api/revisions/b5a3e09c43ce/schema)