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

# Check File Usage

## Check File Usage

Check which agents are using a specific file.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.example.com/api/v1/agent_files/1/usage" \
    -H "X-API-Key: your-api-key-here"
  ```

  ```javascript JavaScript theme={null}
  const fileId = 1;
  const response = await fetch(`https://api.example.com/api/v1/agent_files/${fileId}/usage`, {
    method: 'GET',
    headers: {
      'X-API-Key': 'your-api-key-here'
    }
  });

  const data = await response.json();
  ```

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

  file_id = 1
  headers = {
      'X-API-Key': 'your-api-key-here'
  }

  response = requests.get(
      f'https://api.example.com/api/v1/agent_files/{file_id}/usage',
      headers=headers
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "status": {
      "code": 200,
      "message": "File usage retrieved successfully"
    },
    "data": {
      "file_id": 1,
      "file_name": "product-catalog.pdf",
      "agents": [
        {
          "id": "123",
          "name": "Customer Support Agent"
        },
        {
          "id": "456",
          "name": "Sales Agent"
        }
      ]
    }
  }
  ```
</ResponseExample>

<OpenApiExplorer />