Skip to content

Resource families

koban exposes Invoice Ninja resources through three command profiles:

  • Full — the complete resource command shape: list, show, template, edit-template, create, update, delete, bulk, action, upload.
  • Inspect-only — safe read commands only; show is available only when the official API publishes a single-record route. No generic write commands.
  • Invoices — the full shape plus download and delivery-note.
  • Guarded partial — generic commands are present, but commands for routes not published by the official API fail locally with an explicit message. Some payable/document resources also expose download.

In the library, a subset of resources has typed model accessors (client.invoices(), etc.); every resource is reachable via the generic resource::<T>(Resource) method. See Resource accessors.

CLI resources

CLI nameProfileTyped accessor
clientsFullclients()
invoicesInvoicesinvoices()
paymentsFullpayments()
quotesFullquotes()
creditsFullcredits()
vendorsFullvendors()
expensesFullexpenses()
projectsFullprojects()
tasksFulltasks()
productsFullproducts()
locationsFullgeneric
recurring-invoicesFullgeneric
purchase-ordersFullgeneric
recurring-expensesFullgeneric
recurring-quotesFullgeneric
bank-transactionsFullgeneric
bank-integrationsFullgeneric
bank-transaction-rulesFullgeneric
group-settingsFullgeneric
expense-categoriesFullgeneric
tax-ratesPartialgeneric
payment-termsFullgeneric
task-schedulersFullgeneric
task-statusesFullgeneric
documentsPartialgeneric
designsFullgeneric
templatesPartialgeneric
usersFullgeneric
companiesPartialgeneric
company-gatewaysFullgeneric
company-usersPartialgeneric
tokensFullgeneric
webhooksFullgeneric
subscriptionsFullgeneric
client-gateway-tokensPartialgeneric
activitiesInspect-onlygeneric
system-logsInspect-onlygeneric
company-ledgerInspect-onlygeneric

download is supported for quotes, credits, recurring-invoices, and purchase-orders using the official invitation-key PDF routes.

Import/preimport endpoints are not listable resource families in the official OpenAPI spec. Koban keeps them out of the normal resource table until there is a dedicated guarded workflow.

Endpoint runners

These are not resource families; they run named endpoints (see Endpoint runners):

CLI nameCommand
reportsrun --endpoint reports/...
chartsrun --endpoint charts/...
searchrun
utilityrun
statics(top-level read)

Released under the MIT License.