Workflow: Object Access and Sharing

This workflow covers upload, inspection, listing, deletion, and presigned URL retrieval.

When To Use

Validating data availability in a bucket.
Sharing one-off object downloads with limited validity.
Running object cleanup operations.

Step 1: Upload object via CLI

Use endpoint with scheme for object upload command:


dodil k3 --api-endpoint "https://k3.dev.dodil.io" \
  object create ./sample.pdf --bucket "$K3_BUCKET" --key docs/sample.pdf

Step 2: Inspect object metadata


dodil k3 \
  object show docs/sample.pdf --bucket "$K3_BUCKET"

Step 3: List objects in bucket


dodil k3 \
  object list --bucket "$K3_BUCKET"

Step 4: Generate temporary object URL

URL-encode path separators in object key (/ -> %2F):


curl -sS "https://k3.dev.dodil.io/$K3_BUCKET/objects/docs%2Fsample.pdf/url?expires_in_seconds=1800" \
  -H "Authorization: Bearer $K3_TOKEN" \
  -H "x-organization-id: $K3_ORG"

Step 5: Remove object


dodil k3 \
  object remove docs/sample.pdf --bucket "$K3_BUCKET"

Validation Checks

Upload returns success and object appears in list.
Metadata includes expected size/content fields.
Temporary URL expires as configured.

Next: Operations Checklist