Bucket and Object Commands
This domain covers bucket lifecycle and object admin operations.
Bucket Commands
Command group: dodil k3 bucket
| Subcommand | Args | Important flags |
|---|---|---|
create | <name> | --description, -d |
get | <name> | none |
list | none | none |
delete | <name> | none |
Examples
dodil k3 bucket create kb-dev --description "Dev knowledge bucket"
dodil k3 bucket get kb-dev -o json
dodil k3 bucket list
dodil k3 bucket delete kb-devObject Commands
Command group: dodil k3 object
Persistent flag:
--bucket,-b(required by command behavior)
| Subcommand | Args | Important flags |
|---|---|---|
create | <file-path> | --key, -k |
show | <key> | --bucket, -b |
list | none | --bucket, -b |
remove | <key> | --bucket, -b |
Examples
dodil k3 object create ./sample.pdf --bucket kb-dev --key docs/sample.pdf
dodil k3 object show docs/sample.pdf --bucket kb-dev
dodil k3 object list --bucket kb-dev
dodil k3 object remove docs/sample.pdf --bucket kb-devImportant Behavior Notes
object createperforms raw HTTP PUT and needs a URL scheme in API endpoint.- For object upload, prefer:
dodil k3 --api-endpoint "https://k3.dev.dodil.io" object create ./file --bucket <bucket>- If
--keyis omitted, object key defaults to local file basename.
Common Use Cases
- Bootstrap bucket and verify object metadata from CLI quickly.
- Build shell automations for object housekeeping.
- Pair with API presigned URLs for temporary sharing flows.