Skip to Content
We are live but in Staging 🎉
CLI GuideBucket and Object Commands

Bucket and Object Commands

This domain covers bucket lifecycle and object admin operations.

Bucket Commands

Command group: dodil k3 bucket

SubcommandArgsImportant flags
create<name>--description, -d
get<name>none
listnonenone
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-dev

Object Commands

Command group: dodil k3 object

Persistent flag:

  • --bucket, -b (required by command behavior)
SubcommandArgsImportant flags
create<file-path>--key, -k
show<key>--bucket, -b
listnone--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-dev

Important Behavior Notes

  1. object create performs raw HTTP PUT and needs a URL scheme in API endpoint.
  2. For object upload, prefer:
dodil k3 --api-endpoint "https://k3.dev.dodil.io" object create ./file --bucket <bucket>
  1. If --key is omitted, object key defaults to local file basename.

Common Use Cases

  1. Bootstrap bucket and verify object metadata from CLI quickly.
  2. Build shell automations for object housekeeping.
  3. Pair with API presigned URLs for temporary sharing flows.

Next: Source and Credential Commands