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

# Files

> Upload and manage project documents.

Files represent any document uploaded to your project — drawing sets, specification books, or other project documents.

## Endpoints

| Method   | Endpoint                               | Description      |
| -------- | -------------------------------------- | ---------------- |
| `POST`   | [`/files`](/cms-api/files/create)      | Upload a file    |
| `GET`    | [`/files`](/cms-api/files/list)        | List files       |
| `GET`    | [`/files/{id}`](/cms-api/files/get)    | Get file details |
| `DELETE` | [`/files/{id}`](/cms-api/files/delete) | Delete a file    |

## File Object

| Field        | Type     | Description                                   |
| ------------ | -------- | --------------------------------------------- |
| `id`         | string   | Unique identifier (e.g., `fil_01JABCD123`)    |
| `project_id` | string   | Parent [Project](/cms-api/resources/projects) |
| `filename`   | string   | Original filename                             |
| `name`       | string   | Display name (editable)                       |
| `uri`        | string   | Download URL                                  |
| `mime_type`  | string   | File MIME type                                |
| `page_count` | integer  | Number of pages (for PDFs)                    |
| `status`     | string   | Processing status                             |
| `job_id`     | string   | Processing job ID                             |
| `created_at` | datetime | Upload timestamp                              |
| `updated_at` | datetime | Last modification timestamp                   |

## Processing Statuses

| Status       | Description                           |
| ------------ | ------------------------------------- |
| `Pending`    | File uploaded, waiting for processing |
| `Processing` | File is being analyzed                |
| `Completed`  | Processing finished successfully      |
| `Failed`     | Processing encountered an error       |

## Supported Formats

| Format | Extensions                       | Notes                                 |
| ------ | -------------------------------- | ------------------------------------- |
| PDF    | `.pdf`                           | Primary format for drawings and specs |
| Images | `.png`, `.jpg`, `.jpeg`, `.tiff` | Single-page documents                 |