From 75de4fdb11da8dd210b54442558a496d4e2e8442 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 7 Oct 2026 17:17:16 +0000 Subject: [PATCH] docs: document cli 3.14 and 3.15 commands Assisted-by: Claude Code Claude-Session: https://claude.ai/code/session_015Qg5NUvpUUpqnqd6ow5Xdv --- docs/cli/access-keys.mdx | 2 +- docs/cli/access-keys/delete.mdx | 22 ++++++++++++++--- docs/cli/buckets/list.mdx | 14 ++++++++--- docs/cli/organizations.mdx | 1 + docs/cli/organizations/delete.mdx | 40 +++++++++++++++++++++++++++++++ docs/cli/usage.mdx | 38 +++++++++++++++++++++++++++++ docs/sdks/tigris/using-sdk.mdx | 2 ++ sidebars.js | 2 ++ 8 files changed, 114 insertions(+), 7 deletions(-) create mode 100644 docs/cli/organizations/delete.mdx create mode 100644 docs/cli/usage.mdx diff --git a/docs/cli/access-keys.mdx b/docs/cli/access-keys.mdx index a746d3c2..514f144d 100644 --- a/docs/cli/access-keys.mdx +++ b/docs/cli/access-keys.mdx @@ -18,7 +18,7 @@ t3 keys [flags] | -------------------------------- | ------------------------------------------------ | | [`list`](list) | List all access keys in the current organization | | [`create`](create) | Create a new access key | -| [`delete`](delete) | Permanently delete an access key | +| [`delete`](delete) | Permanently delete one or more access keys | | [`get`](get) | Show details for an access key | | [`assign`](assign) | Assign per-bucket roles to an access key | | [`rotate`](rotate) | Rotate an access key's secret | diff --git a/docs/cli/access-keys/delete.mdx b/docs/cli/access-keys/delete.mdx index 3905949d..1ecc4475 100644 --- a/docs/cli/access-keys/delete.mdx +++ b/docs/cli/access-keys/delete.mdx @@ -1,18 +1,34 @@ # tigris access-keys delete -Permanently delete an access key by its ID. This revokes all access immediately. +Permanently delete one or more access keys by ID. This revokes all access +immediately. **Alias:** `d` ## Usage ```bash -tigris access-keys delete -t3 keys d +tigris access-keys delete [flags] +t3 keys d [flags] ``` +## Flags + +| Name | Required | Default | Description | +| ------------- | -------- | ------- | ------------------------------------------- | +| `--yes`, `-y` | No | — | Skip confirmation prompts | +| `--force` | No | — | Skip confirmation prompts (alias for --yes) | + +To delete several keys, pass a comma-separated list of IDs. One confirmation +covers the whole list. Each key is deleted in turn; if one fails, the rest are +still deleted, and the command exits with a non-zero status. + ## Examples ```bash +# Delete a single access key tigris access-keys delete tid_AaBbCcDdEeFf + +# Delete several access keys without the confirmation prompt +tigris access-keys delete tid_AaBb,tid_CcDd --yes ``` diff --git a/docs/cli/buckets/list.mdx b/docs/cli/buckets/list.mdx index a70da657..9eb3f488 100644 --- a/docs/cli/buckets/list.mdx +++ b/docs/cli/buckets/list.mdx @@ -13,13 +13,21 @@ t3 b l [flags] ## Flags -| Name | Required | Default | Description | -| ---------------- | -------- | ------- | ---------------------------------------------- | -| `--format`, `-f` | No | `table` | Output format. Options: `json`, `table`, `xml` | +| Name | Required | Default | Description | +| ---------------- | -------- | ------- | -------------------------------------------------------------------- | +| `--format`, `-f` | No | `table` | Output format. Options: `json`, `table`, `xml` | +| `--forks-only` | No | — | Only list buckets that are forks of another bucket | +| `--owner` | No | — | Only list buckets owned by this user, by username (an email address) | ## Examples ```bash tigris buckets list tigris buckets list --format json + +# Only buckets that are forks of another bucket +tigris buckets list --forks-only + +# Only buckets owned by one user +tigris buckets list --owner alice@example.com ``` diff --git a/docs/cli/organizations.mdx b/docs/cli/organizations.mdx index a30ae2f2..50cfa2d3 100644 --- a/docs/cli/organizations.mdx +++ b/docs/cli/organizations.mdx @@ -18,4 +18,5 @@ t3 orgs [flags] tigris orgs list tigris orgs create my-org tigris orgs select my-org +tigris orgs delete ``` diff --git a/docs/cli/organizations/delete.mdx b/docs/cli/organizations/delete.mdx new file mode 100644 index 00000000..fdbaca55 --- /dev/null +++ b/docs/cli/organizations/delete.mdx @@ -0,0 +1,40 @@ +# tigris organizations delete + +Delete an organization you own, picked from a list or given by ID. Requires +OAuth login (`tigris login oauth`). + +**Alias:** `d` + +## Usage + +```bash +tigris organizations delete [id] [flags] +t3 orgs d [id] [flags] +``` + +## Flags + +| Name | Required | Default | Description | +| ------------- | -------- | ------- | ------------------------- | +| `--yes`, `-y` | No | — | Skip confirmation prompts | + +With no ID, the command lists your organizations and lets you pick one. +Organization names are not unique, so pass an ID rather than a name. The command +asks for confirmation before deleting; `--yes` skips it. + +The organization must be empty first: no buckets, access keys, policies, teams, +or other members. Its shares and invitations are removed with it. You cannot +delete your last organization, and Fly.io organizations are not available here. + +If you delete your active organization, the first remaining organization becomes +active, and the command prints its name. + +## Examples + +```bash +# Pick the organization to delete from a list +tigris orgs delete + +# Delete by ID without the confirmation prompt +tigris orgs delete --yes +``` diff --git a/docs/cli/usage.mdx b/docs/cli/usage.mdx new file mode 100644 index 00000000..6fecb656 --- /dev/null +++ b/docs/cli/usage.mdx @@ -0,0 +1,38 @@ +# tigris usage + +Show the active organization's usage and charges for a billing month, as on the +console's Usage page. Requires OAuth login (`tigris login oauth`). + +## Usage + +```bash +tigris usage [flags] +t3 usage [flags] +``` + +## Flags + +| Name | Required | Default | Description | +| ---------- | -------- | ------------- | ------------------------------------------------ | +| `--month` | No | Current month | Billing month as `YYYY-MM` | +| `--all` | No | — | Show every line item, even those with zero usage | +| `--format` | No | `table` | Output format. Options: `json`, `table`, `xml` | + +Line items with zero usage are hidden unless you pass `--all`. `--format json` +returns the full invoice. + +## Examples + +```bash +# This month's usage and charges +tigris usage + +# A previous month +tigris usage --month 2026-09 + +# Include line items with zero usage +tigris usage --all + +# Full invoice as JSON +tigris usage --format json +``` diff --git a/docs/sdks/tigris/using-sdk.mdx b/docs/sdks/tigris/using-sdk.mdx index 007fff71..6f2181b7 100644 --- a/docs/sdks/tigris/using-sdk.mdx +++ b/docs/sdks/tigris/using-sdk.mdx @@ -604,6 +604,8 @@ listBuckets(options?: ListBucketsOptions): Promise