> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/cli/reference/files.md). # norbix files Upload, download and manage files. Upload, download and manage files. 9 commands (`@norbix.ai/cli` 1.16.0): * [`norbix files delete`](#norbix-files-delete) — Delete one file * [`norbix files download`](#norbix-files-download) — Download a file to disk (via a signed URL) * [`norbix files info`](#norbix-files-info) — Show metadata for one file * [`norbix files integrations test`](#norbix-files-integrations-test) — Check that a files integration really works * [`norbix files list`](#norbix-files-list) — List files in a folder of a files integration * [`norbix files publish`](#norbix-files-publish) — Make a file (or a whole folder) readable by anyone holding its link — no sign-in needed * [`norbix files sign`](#norbix-files-sign) — Get a temporary signed download URL for a file * [`norbix files unpublish`](#norbix-files-unpublish) — Take away a file's (or a folder's) public link * [`norbix files upload`](#norbix-files-upload) — Upload a local file (three steps: get signed URL, PUT bytes, commit). ## `norbix files delete` Delete one file ```sh norbix files delete REMOTE [flags] ``` | Argument | Required | Description | | -------- | -------- | ---------------- | | `REMOTE` | yes | Remote file path | | Flag | Description | | ------------------------------- | ---------------------------------------------------------------------- | | `-i`, `--integration` `` | Files integration ID — env: `NORBIX_FILES_INTEGRATION_ID` | | `-y`, `--yes` | Skip the confirmation prompt (required in non-interactive shells) | | `--dry-run` | Resolve context and print the request that would be sent; send nothing | Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`. Examples: ```sh norbix files delete invoices/2026/invoice.pdf --yes norbix files delete invoices/2026/invoice.pdf --dry-run ``` ## `norbix files download` Download a file to disk (via a signed URL) ```sh norbix files download REMOTE [FILE] [flags] ``` | Argument | Required | Description | | -------- | -------- | --------------------------------------------------------------- | | `REMOTE` | yes | Remote file path | | `FILE` | no | Local target file (default: remote file name in current folder) | | Flag | Description | | ------------------------------- | --------------------------------------------------------- | | `-i`, `--integration` `` | Files integration ID — env: `NORBIX_FILES_INTEGRATION_ID` | Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`. Examples: ```sh norbix files download invoices/2026/invoice.pdf norbix files download invoices/2026/invoice.pdf ./local-copy.pdf ``` ## `norbix files info` Show metadata for one file ```sh norbix files info REMOTE [flags] ``` | Argument | Required | Description | | -------- | -------- | ---------------- | | `REMOTE` | yes | Remote file path | | Flag | Description | | ------------------------------- | --------------------------------------------------------- | | `-i`, `--integration` `` | Files integration ID — env: `NORBIX_FILES_INTEGRATION_ID` | Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`. Examples: ```sh norbix files info invoices/2026/invoice.pdf ``` ## `norbix files integrations test` Check that a files integration really works ``` Runs a live probe against the storage: uploads a small file, reads it, lists its folder and deletes it again. Prints one line per step — OK, FAILED or NOT_TESTED (skipped because an earlier step failed) — with the errors of a failed step. Exits non-zero unless every step is OK. Needs the files:create permission, because the probe writes to the storage. ``` ```sh norbix files integrations test ID ``` | Argument | Required | Description | | -------- | -------- | -------------------- | | `ID` | yes | Files integration ID | Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`. Examples: ```sh norbix files integrations test 55555555-5555-5555-5555-555555555555 norbix files integrations test 55555555-5555-5555-5555-555555555555 --json ``` ## `norbix files list` List files in a folder of a files integration ```sh norbix files list [PATH] [flags] ``` | Argument | Required | Description | | -------- | -------- | --------------------------- | | `PATH` | no | Folder path (default: root) | | Flag | Description | | ------------------------------- | --------------------------------------------------------- | | `-i`, `--integration` `` | Files integration ID — env: `NORBIX_FILES_INTEGRATION_ID` | Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`. Examples: ```sh norbix files list --integration 66b2f0a1c3d4e5f6a7b8c9d0 norbix files list invoices/2026 ``` ## `norbix files publish` Make a file (or a whole folder) readable by anyone holding its link — no sign-in needed ```sh norbix files publish REMOTE [flags] ``` | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `REMOTE` | yes | Remote file path, or folder prefix with --folder | | Flag | Description | | ------------------------------- | ---------------------------------------------------------------------- | | `--dry-run` | Resolve context and print the request that would be sent; send nothing | | `--folder` | Publish the whole folder prefix instead of one file | | `-i`, `--integration` `` | Files integration ID — env: `NORBIX_FILES_INTEGRATION_ID` | Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`. Examples: ```sh norbix files publish invoices/2026/invoice.pdf norbix files publish invoices --folder norbix files publish invoices/2026/invoice.pdf --dry-run ``` ## `norbix files sign` Get a temporary signed download URL for a file ```sh norbix files sign REMOTE [flags] ``` | Argument | Required | Description | | -------- | -------- | ---------------- | | `REMOTE` | yes | Remote file path | | Flag | Description | | ------------------------------- | --------------------------------------------------------- | | `-i`, `--integration` `` | Files integration ID — env: `NORBIX_FILES_INTEGRATION_ID` | | `--expires` `` | URL lifetime in seconds | Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`. Examples: ```sh norbix files sign invoices/2026/invoice.pdf --expires 3600 ``` ## `norbix files unpublish` Take away a file's (or a folder's) public link ```sh norbix files unpublish REMOTE [flags] ``` | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `REMOTE` | yes | Remote file path, or folder prefix with --folder | | Flag | Description | | ------------------------------- | ---------------------------------------------------------------------- | | `--dry-run` | Resolve context and print the request that would be sent; send nothing | | `--folder` | Unpublish the whole folder prefix, and every link inside it | | `-i`, `--integration` `` | Files integration ID — env: `NORBIX_FILES_INTEGRATION_ID` | Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`. Examples: ```sh norbix files unpublish invoices/2026/invoice.pdf norbix files unpublish invoices --folder norbix files unpublish invoices/2026/invoice.pdf --dry-run ``` ## `norbix files upload` Upload a local file (three steps: get signed URL, PUT bytes, commit). ```sh norbix files upload FILE [REMOTE] [flags] ``` | Argument | Required | Description | | -------- | -------- | --------------------------------------------------- | | `FILE` | yes | Local file to upload | | `REMOTE` | no | Remote path (default: file name in the root folder) | | Flag | Description | | ------------------------------- | ---------------------------------------------------------------------- | | `--dry-run` | Resolve context and print the request that would be sent; send nothing | | `-i`, `--integration` `` | Files integration ID — env: `NORBIX_FILES_INTEGRATION_ID` | | `--content-type` `` | MIME type (default: guessed from extension) | Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`. Examples: ```sh norbix files upload ./invoice.pdf norbix files upload ./invoice.pdf invoices/2026/invoice.pdf norbix files upload ./invoice.pdf --dry-run ```