SDKs and CLI

Generate and use BlendDuck clients in eight languages, or manage posts from the CLI.

Documentation owner:
BlendDuck Documentation
Last reviewed:

BlendDuck generates TypeScript, Python, Go, Java, PHP, Ruby, .NET, and Rust packages from the published OpenAPI 3.1 contract. A digest manifest makes stale or hand-modified artifacts fail CI.

pnpm sdk:generate
pnpm sdk:check
pnpm verify:sdks

TypeScript and Python clients are exercised independently against a disposable real app. The other six packages are regenerated from the same 25-operation catalog and compiled or syntax-checked wherever their local toolchain is available.

CLI quickstart

Use a least-privilege organization key with workspace:read, channels:read, posts:read, and posts:write, then keep it outside the command line:

export BLENDDUCK_API_KEY="..."
blendduck auth status
blendduck posts create \
  --channel <channel-id> \
  --content "First SDK-backed draft" \
  --idempotency-key first-draft-001

The CLI also supports post list, get, update, and delete. It rejects an --api-key flag to keep credentials out of shell history and process listings. All output uses the standard public API envelope.

See the repository's complete SDK and CLI guide and the OpenAPI reference.