bexio Files
bexio_filesList, search, upload, download, preview, update, and delete files stored in bexio, including attachments.
Instructions
Manage files stored in bexio (uploads, attachments; 3.0 API). Actions: "list" (all files; optional archived_state, offset, order_by — order_by fields: id, created_at, source_id, uuid, name, size_in_bytes, comma-combinable with "_asc"/"_desc" suffix), "search" (search_criteria required; searchable fields: id, uuid, created_at, name, extension, size_in_bytes, mime_type, user_id, is_archived, source_id; optional archived_state, limit, offset), "get" (file metadata by id), "download" (file content by id; returns base64 or writes to optional save_path), "preview" (preview image of the file by id; returns base64 or writes to optional save_path), "usage" (where the file is attached: reference class, title, document number; by id), "upload" (create a new file from file_path on disk OR content_base64 + file_name; file_name overrides the file_path basename), "update" (id + payload: name, is_archived, source_type), "delete" (marks the file as deleted by id — cannot be undone).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | File id (required for get/download/preview/usage/update/delete) | |
| limit | No | Maximum number of results for "search" (default 500, max 2000) | |
| action | Yes | Operation to perform | |
| offset | No | Number of results to skip for "list"/"search" | |
| payload | No | File fields for "update"; send only the fields to change (PATCH semantics). | |
| order_by | No | Sort order for "list": id, created_at, source_id, uuid, name or size_in_bytes; append "_asc"/"_desc" and combine multiple fields with a comma | |
| file_name | No | File name including extension (required for "upload" with content_base64; overrides the file_path basename) | |
| file_path | No | Path of a local file to upload (for "upload") | |
| save_path | No | For "download"/"preview": write the file to this local path instead of returning base64 inline | |
| archived_state | No | Include/exclude archived files for "list" and "search" | |
| content_base64 | No | Base64-encoded file content to upload (for "upload", alternative to file_path) | |
| search_criteria | No | Search conditions, combined with logical AND |