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

# Arquivos

> Chame /files com o SDK TypeScript.

**Métodos**: `client.uploadFile()`, `client.listFiles()`, `client.getFile()`, `client.getFileContent()`.

### Exemplo

```typescript theme={null}
const uploaded = await client.uploadFile({ purpose: "batch", file: new Blob(["{}"]) });
const file = await client.getFile(uploaded.id);
const content = await client.getFileContent(uploaded.id);
```

<Note>
  `client.listFiles()` existe, mas `GET /files` retorna atualmente `file_list_not_supported_with_shared_gateway_key`
  ao usar a chave compartilhada do gateway. Salve o valor `uploaded.id` e recupere os arquivos diretamente.
</Note>

### Parâmetros principais

* `file` (obrigatório para upload): Blob/File/base64/string.
* `purpose` (obrigatório para upload): por exemplo, `batch`.

### Retorna

`FileObject` (upload/consulta)

```json theme={null}
{
  "id": "file-123",
  "object": "file",
  "filename": "data.json",
  "purpose": "batch",
  "status": "processed",
  "created_at": 1677610602,
  "bytes": 123
}
```

Ou `FileListResponse` (listagem quando a chave do provedor subjacente permitir enumerar arquivos)

```json theme={null}
{
  "data": [
    {
      "id": "file-123",
      "object": "file",
      "filename": "data.json",
      "purpose": "batch",
      "status": "processed",
      "created_at": 1677610602,
      "bytes": 123
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.