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

# Files

> Every published files operation, generated from the contract.

5 operations on `client.files`, including `files.uploads`, `files.versions`.

Path parameters come first, positionally; the request body is last, as a plain
object. Method names are `snake_case` in Python and `camelCase` in
TypeScript, and resource names follow the same rule.

<CodeGroup>
  ```python Python theme={null}
  result = client.files.get_content(file_id)
  ```

  ```typescript TypeScript theme={null}
  const result = await client.files.getContent(file_id);
  ```
</CodeGroup>

## Operations

| Call                                                          | Route                                                             | Does                                  |
| ------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------- |
| `client.files.get_content(file_id)`                           | `GET /file/v1/files/{file_id}/content`                            | Fetch the latest file content         |
| `client.files.list()`                                         | `GET /file/v1/files`                                              | List files by owner                   |
| `client.files.uploads.create(body)`                           | `POST /file/v1/files/uploads`                                     | Reserve an upload destination         |
| `client.files.uploads.ingest(upload_key, body)`               | `PUT /file/v1/files/uploads/{upload_key}`                         | Upload bytes through the gateway      |
| `client.files.versions.get_content(file_id, version_ordinal)` | `GET /file/v1/files/{file_id}/versions/{version_ordinal}/content` | Fetch a pinned file version's content |

## Related

<CardGroup cols={2}>
  <Card title="How the client is organised" icon="list" href="/sdk/operations">
    Resources, call shapes, and errors.
  </Card>

  <Card title="Errors and retries" icon="triangle-exclamation" href="/developers/errors-and-retries">
    What the SDK raises, and which calls are safe to retry.
  </Card>
</CardGroup>
