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

# Bulk File Operations

Perform operations on multiple files efficiently.

## Request Body

<ParamField body="operation" type="string" required>
  The operation to perform: `delete`, `update_tags`, `change_status`
</ParamField>

<ParamField body="file_ids" type="array" required>
  Array of file IDs to operate on
</ParamField>

<ParamField body="parameters" type="object">
  Operation-specific parameters
</ParamField>

### Bulk Delete

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.artaios.ai/api/v1/files/bulk/ \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "operation": "delete",
      "file_ids": ["file_123", "file_456", "file_789"]
    }'
  ```

  ```python Python theme={null}
  import requests

  data = {
      "operation": "delete",
      "file_ids": ["file_123", "file_456", "file_789"]
  }

  response = requests.post(
      "https://api.artaios.ai/api/v1/files/bulk/",
      headers={"x-api-key": "YOUR_API_KEY"},
      json=data
  )
  result = response.json()
  ```
</CodeGroup>

### Bulk Update Tags

```json theme={null}
{
  "operation": "update_tags",
  "file_ids": ["file_123", "file_456"],
  "parameters": {
    "tags": ["updated", "batch_processed"]
  }
}
```

## Response

```json theme={null}
{
  "success": true,
  "processed": 3,
  "failed": 0,
  "results": [
    {
      "file_id": "file_123",
      "status": "success"
    },
    {
      "file_id": "file_456", 
      "status": "success"
    },
    {
      "file_id": "file_789",
      "status": "success"
    }
  ]
}
```