Skip to main content

Global flags

FlagDescription
--params '<JSON>'Query, path and header parameters (id, page, filters, X-Workspace-Id)
--json '<JSON>'Request body (POST/PUT/PATCH)
--fields '<FIELDS>'Limits which fields come back in the response
--dry-runShows the request (URL, query, headers and body) without executing it
--page-allAuto-pagination with NDJSON output
--page-limit <N>Maximum number of pages (default: 10)
--page-delay <MS>Delay between pages (default: 100ms)
--env <ENV>Environment: production (default), sandbox, development
--verboseRequest details on stderr
--output <PATH>Saves the response to a file
--output-format <FMT>Format: json, table, csv
--idempotency-key <KEY>Custom idempotency key
--lang <LANG>Language of the messages: pt, en or es (default: the system's)

Headers in --params​

A --params key that the endpoint declares as a header goes in the header, not the URL. That is how you switch workspace for a single call — --params '{"X-Workspace-Id": "WORKSPACE_ID"}' —, taking precedence over KOBANA_WORKSPACE_ID. kobana schema lists those headers under header_params.

Language​

The CLI speaks Portuguese, English or Spanish: help, messages, errors and command descriptions. The language comes, in this order, from --lang, the KOBANA_LANG variable, the terminal's locale variables (LC_ALL, LC_MESSAGES, LANG) and, last, the system language.

kobana --lang pt dunning --help
export KOBANA_LANG=es

Command and flag names, JSON keys and exit codes never change with the language. Available since version 0.6.0.

Next steps​

  • Usage — syntax, resources, examples.
  • Schema introspection — parameters, required fields, types and responses.