Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /files | Upload a file |
GET | /files | List files |
GET | /files/{id} | Get file details |
DELETE | /files/{id} | Delete a file |
File Object
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier (e.g., fil_01JABCD123) |
project_id | string | Parent Project |
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 | Primary format for drawings and specs | |
| Images | .png, .jpg, .jpeg, .tiff | Single-page documents |