CLI & API

Web for most people. CLI when you are in a terminal. API when your agent should do the work — same domain services underneath.

Get started

1. Sign in
Create an account and sign in to Puffin Domains.
2. Create an API token
Call POST /api/account/api-tokens while signed in. The token is shown once (dbk_…).
3. Run the CLI
Set DOM_API_TOKEN and run npm run cli — or point DOM_API_BASE at production.

Useful commands

npm run cli -- search example
npm run cli -- list
npm run cli -- inspect example.com
npm run cli -- dns list example.com
npm run cli -- email create hello@example.com --confirm
npm run cli -- email status hello@example.com

HTTP API

Versioned under /api/v1 with Bearer tokens. Domain and email access have separate read/write scopes. Mutations require confirmed: true, and sensitive calls require Puffin MFA.

Go to My account when signed in to manage access.