Skip to Content
We are live but in Staging 🎉
PipelinesCLI Guidedodil k3 source

dodil k3 source

You usually don’t need this command. Every bucket gets an auto-created internal S3 source on CreateBucket — direct uploads trigger pipelines without you registering anything. The dodil k3 source create command is for adding external sources, which are Preview.

Preview — external sources (Google Drive, SharePoint, Confluence, GitHub) and the source-management CLI / API are still solidifying for production. Direct S3 upload through the auto-created internal source is the production ingest channel today.

dodil k3 source create

dodil k3 source create [name] -b BUCKET

Creates a new source row on the bucket. The CLI takes only name and --bucket today — to set provider, root path, sync interval, or provider-specific account info, use the API directly or update the source afterward via the API.

FlagShortTypeDescription
--bucket-bstringRequired. Bucket to attach the source to.

Example:

dodil k3 source create contracts-source -b kb-prod

The created source defaults to provider = SOURCE_PROVIDER_INTERNAL_S3 and sync_interval_seconds = 0 (manual only).

Adding a real external source (via API)

The CLI doesn’t yet expose provider/root_path/sync_interval flags. For external sources, hit the API directly:

# Google Drive source
curl -sS -X POST "https://k3.dev.dodil.io/kb-prod/sources" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bucket": "kb-prod",
    "provider": "SOURCE_PROVIDER_GOOGLE_DRIVE",
    "name": "finance-drive",
    "rootPath": "/Q2",
    "providerAccount": "drive-id-123",
    "syncIntervalSeconds": "3600",
    "enabled": true
  }'

You’ll typically also need to store a credential for the source.

Listing sources (via API)

Until dodil k3 source list lands, use:

curl -sS "https://k3.dev.dodil.io/kb-prod/sources" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  | jq '.sources[] | {sourceId, name, provider, status}'

The bucket’s internal source appears with name: "internal" and provider: "SOURCE_PROVIDER_INTERNAL_S3".

See also

Overviewdodil k3 credential