Skip to main content

Introduction

kobana is a single command-line tool for every Kobana product's API — Magic Dashboard included. It is built and maintained in its own repository (kobana-cli), not by this product, and it does not hardcode endpoints: at startup it parses the OpenAPI 3.1 specs embedded in the binary and builds its command tree from them. Updating the API surface is a matter of refreshing the embedded spec and shipping a new build — no per-endpoint code.

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

Designed for both humans and AI agents: structured JSON output by default, schema introspection, --dry-run and automatic pagination.

Products​

ProductDescription
bankingBanking Gateway — charges, payments, transfers (API v1 and v2)
financeSmart Finance — payables and receivables, transactions, cash flow
billingAutomatic Billing — subscriptions, plans, invoices, tax documents
inboxAutonomous Inbox — inboxes, agents, e-mails, webhooks
dunningDunning — debtors, charges, collection rules, agreements, credit bureau listings
dashboardsMagic Dashboard — data sources, entities, portal, workspaces

The dashboards product talks to the same API documented on this site. Its resources — see the full catalogue — point at 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 it — see Installation.

  2. Authenticate for Magic Dashboard and, if the organization has more than one workspace, pick the one to act on. See Authentication.

  3. Make your first call:

    kobana dashboards data-sources list --fields "id,name,kind,status"

  4. Explore the surface — every command supports --help, and kobana schema introspects any endpoint's parameters and body without leaving the terminal.

Next steps​