Files
GET /api/orgs/{org_id}/files
Section titled “GET /api/orgs/{org_id}/files”List Files
List files in the organization, newest first.
Mirrors the detail endpoint’s scoping: org membership is sufficient,
since org_id is a direct column on every file — this surfaces
exactly what GET /{file_id} already lets a member read one at a
time, it does not widen access.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| limit | query | integer | no | Max rows to return (1-100). Omit to return every row. |
| offset | query | integer | no | Rows to skip — pass the previous response’s next_offset. |
| org_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | Page_FileDetailResponse_ |
| 422 | Validation Error | HTTPValidationError |
GET /api/orgs/{org_id}/files/{file_id}
Section titled “GET /api/orgs/{org_id}/files/{file_id}”Get File
Get a single file’s metadata by ID.
Requires membership in the organization.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| file_id | path | string (uuid) | yes | |
| org_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | FileDetailResponse |
| 422 | Validation Error | HTTPValidationError |
GET /api/orgs/{org_id}/files/{file_id}/download
Section titled “GET /api/orgs/{org_id}/files/{file_id}/download”Download File
Download a file (forces a native browser download).
Requires membership in the organization.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| file_id | path | string (uuid) | yes | |
| org_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | object |
| 422 | Validation Error | HTTPValidationError |
GET /api/orgs/{org_id}/files/{file_id}/view
Section titled “GET /api/orgs/{org_id}/files/{file_id}/view”View File
Serve a file inline so it renders in a browser tab / iframe / img.
Identical to /download but uses Content-Disposition: inline.
Requires membership in the organization.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| file_id | path | string (uuid) | yes | |
| org_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | object |
| 422 | Validation Error | HTTPValidationError |