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

# Files

> Use the PHP SDK for file upload, metadata, and file-content retrieval.

**Methods**: `uploadFile()`, `listFiles()`, `retrieveFile()`, `retrieveFileContent()`

### Example

```php theme={null}
<?php

require 'vendor/autoload.php';

use AIStats\Sdk\AIStats;

$apiKey = getenv('AI_STATS_API_KEY');
$client = new AIStats(apiKey: $apiKey);

$uploaded = $client->uploadFile([
    'purpose' => 'batch',
    'file' => 'data:application/json;base64,eyJ0ZXN0Ijp0cnVlfQ==',
]);

$file = $client->retrieveFile('file_123');
$content = $client->retrieveFileContent('file_123');
```

<Note>
  `listFiles()` is wired through the SDK, but `GET /files` currently returns `file_list_not_supported_with_shared_gateway_key`
  on the shared gateway key. Persist uploaded file ids and retrieve them directly instead.
</Note>