Skip to main content

Introduction

kobana is a single command-line tool for the APIs of every Kobana product — the Kadu Agent included. It is built and maintained in its own repository (kobana-cli), not by this product, and has no hand-written endpoint at all: on startup it reads the OpenAPI 3.1 specs embedded in the binary and builds the command tree from them. Updating the API surface is a matter of updating the embedded spec and publishing a new build — no code per endpoint.

kobana <product> <resource> <method> [flags]

Built for people and AI agents alike: structured JSON output by default, schema introspection, --dry-run and automatic pagination. It has no shortcut the API lacks: token, scope, role and limits are the API's.

Products​

ProductDescription
bankingBanking Gateway — charges, payments, transfers (API v1 and v2)
financeSmart Finance — accounts payable and receivable, transactions, cash flow
billingAutomated Billing — subscriptions, plans, invoices, tax invoices
inboxAutonomous Inbox — inboxes, agents, emails, webhooks
dunningCollection Rules — rules, steps and dispatches
dashboardsMagic Dashboard — dashboards and panels
kaduKadu Agent — tasks, executions, pending items, environments, secrets, schedules and webhooks

The kadu product talks to the same API documented on this site. Its resources — see the full catalog — point to the same endpoints as the API Reference; the CLI is just another way to call it. It does not share credentials with the other products: see Authentication.

Getting started​

  1. Install — see Installation.

  2. Authenticate with the product you will use. See Authentication.

  3. Make the first call:

    kobana kadu tasks list --fields "id,skill_slug,label"

  4. Explore the surface — every command accepts --help, and kobana schema shows the parameters and body of any endpoint without leaving the terminal.

If the command says kadu is not a product, your CLI version predates Kadu: update it (kobana update or brew upgrade kobana).

Next steps​