## Bulk delete documents

`documents.delete_bulk(DocumentDeleteBulkParams**kwargs)  -> DocumentDeleteBulkResponse`

**delete** `/v3/documents/bulk`

Bulk delete documents by IDs or container tags

### Parameters

- `container_tags: Optional[Sequence[str]]`

  Array of container tags - all documents in these containers will be deleted

- `filepath: Optional[str]`

  Delete documents matching this filepath. Exact match for full paths, prefix match if ending with /

- `ids: Optional[Sequence[str]]`

  Array of document IDs to delete (max 100 at once)

### Returns

- `class DocumentDeleteBulkResponse: …`

  Response for bulk document deletion

  - `deleted_count: float`

    Number of documents successfully deleted

  - `success: bool`

    Whether the bulk deletion was successful

  - `container_tags: Optional[List[str]]`

    Container tags that were processed (only applicable when deleting by container tags)

  - `errors: Optional[List[Error]]`

    Array of errors for documents that couldn't be deleted (only applicable when deleting by IDs)

    - `id: str`

    - `error: str`

### Example

```python
import os
from supermemory import Supermemory

client = Supermemory(
    api_key=os.environ.get("SUPERMEMORY_API_KEY"),  # This is the default and can be omitted
)
response = client.documents.delete_bulk()
print(response.deleted_count)
```

#### Response

```json
{
  "deletedCount": 2,
  "success": true,
  "containerTags": [
    "string"
  ],
  "errors": [
    {
      "id": "id",
      "error": "error"
    }
  ]
}
```