akb_put_file
Upload a local file to a vault's S3-backed storage for PDFs, images, or datasets. Returns a URI for retrieval or deletion.
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}/coll/{collection}/file/{uuid} when stored under a collection, or akb://{vault}/file/{uuid} at the vault root — 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 |
|---|---|---|---|
| parent | No | Parent location as a canonical URI — `akb://{vault}` for the vault root, `akb://{vault}/coll/{path}` for a collection. When given, the file is uploaded there and `vault`/`collection` are derived from the URI. | |
| vault | No | Vault name. Required unless `parent` is given. | |
| file_path | Yes | Absolute path to the local file to upload | |
| collection | No | Logical grouping (like document collections). Ignored when `parent` is given. | |
| 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. |