akb_put_file
Upload a local file to a vault's S3-backed file storage. Ideal for PDFs, images, and large datasets; returns a URI for retrieval or deletion. MIME type auto-detected.
Instructions
Upload a local file to a vault's file storage (S3-backed). Use for PDFs, images, datasets, or any binary content too large for akb_put. Response includes the canonical uri (akb://{vault}/file/{id}) — pass that to akb_get_file / akb_delete_file. MIME type is auto-detected from the filename extension unless overridden.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vault | Yes | Vault name (new files are not URI-addressable yet, so the placement vault is named explicitly) | |
| file_path | Yes | Absolute path to the local file to upload | |
| collection | No | Logical grouping (like document collections) | |
| description | No | Brief description of the file | |
| mime_type | No | MIME type of the file (e.g. 'text/html', 'application/pdf', 'image/png'). Optional — if omitted, it is auto-detected from the filename extension. Override only when the extension is missing, ambiguous, or wrong. |