Skip to Content
We are live but in Staging 🎉

dodil k3 bucket

Manage K3 bucketscreate, get, list, update, delete. Mirrors Buckets — API Reference.

Bucket-scoped sub-groups: dodil k3 bucket policy (S3-style ACL) and dodil k3 bucket cors (CORS configuration).

dodil k3 bucket create

dodil k3 bucket create [name] [flags]

Creates a new bucket scoped to the caller’s org. Defaults from the API apply (access_mode = PRIVATE, storage_quota_bytes = 0 = unlimited) — the CLI does not currently expose flags for them.

FlagShortTypeDescription
--description-dstringHuman-readable bucket description

Examples:

dodil k3 bucket create kb-prod dodil k3 bucket create kb-prod -d "Production knowledge base"

dodil k3 bucket get

dodil k3 bucket get [name]

Fetches a bucket by name. Output format follows the global --output flag (default table; use --output json for machine-readable).

Example:

dodil k3 bucket get kb-prod --output json

dodil k3 bucket list

dodil k3 bucket list

Lists all buckets in the caller’s org. Pagination and search filtering exist on the underlying ListBuckets API but are not surfaced as CLI flags today.

dodil k3 bucket update

dodil k3 bucket update [name] [flags]

Patches mutable fields on a bucket — only the flags you pass are sent. Anything you don’t pass stays unchanged. Mirrors UpdateBucket.

FlagShortTypeDescription
--description-dstringHuman-readable description
--storage-quota-bytesint64Storage quota in bytes (0 = unlimited)
--access-modestringprivate | public | custom — the CLI uses these friendly values and maps to BUCKET_ACCESS_MODE_* for the API

Examples:

# Change just the description dodil k3 bucket update kb-prod -d "Renamed bucket" # Make it public dodil k3 bucket update kb-prod --access-mode public # Set a 10 GiB quota dodil k3 bucket update kb-prod --storage-quota-bytes 10737418240 # Multiple fields at once dodil k3 bucket update kb-prod -d "Tighter quota" --storage-quota-bytes 5368709120

dodil k3 bucket delete

dodil k3 bucket delete [name]

Deletes a bucket. Be sure it’s empty (the API will refuse to delete a non-empty bucket).

Example:

dodil k3 bucket delete kb-prod

See also