> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getagentdrive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Delete Files

> Delete multiple files in a single request.

## Request Body

<ParamField body="file_ids" type="string[]" required>
  An array of file IDs to delete. Maximum 1000 IDs per request.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.getagentdrive.com/v0/files/bulk-delete \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "file_ids": ["file_abc123", "file_def456", "file_ghi789"]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "deleted": ["file_abc123", "file_def456"],
    "failed": ["file_ghi789"]
  }
  ```
</ResponseExample>

## Response

<ResponseField name="deleted" type="string[]">
  The IDs of files that were successfully deleted.
</ResponseField>

<ResponseField name="failed" type="string[]">
  The IDs of files that could not be deleted (e.g., not found or permission denied).
</ResponseField>
