Skip to content

Global options

Every command accepts these flags. They can appear anywhere on the command line (before or after the subcommand).

Flag Description Default
-p, --profile <name> Use a specific profile Active profile
--api-url <url> Override API URL Profile URL or https://api.truto.one
--token <token> Override API token Profile token
-o, --output <format> json, table, yaml, csv, ndjson table
-v, --verbose Print request/response details to stderr Off
--no-color Disable colored output Off
--no-help-on-error Suppress automatic --help on errors (for piping) Off
Tip

When -o is json, yaml, csv, or ndjson, decorative status messages are suppressed on stdout so only structured data is emitted. Errors always go to stderr.

Output formats

Format Best for Notes
table Interactive inspection Default. Truncates long values; up to 8 columns.
json Piping to jq, saving files Pretty-printed, 2-space indent.
ndjson Streaming, log processing One JSON object per line. Ideal for export.
csv Spreadsheets Columns from first record.
yaml Human-readable nested data

Some commands override the default:

Command Default output
Most admin commands table
export json (unless -o is set)
get subcommands json
custom json

Pagination

List commands return 25 results by default:

truto integrations list --limit 10
# Output shows: Next page: --next-cursor abc123...
truto integrations list --limit 10 --next-cursor abc123

For exhaustive pagination across data-plane resources, use truto export instead.

Shared resource flags

Most admin resource commands support:

Flag Operation Description
--next-cursor <cursor> list Next page
--limit <n> list Results per page (default 25)
--stdin create Body from stdin (JSON array or NDJSON)
-i, --interactive update Pre-fill fields from current record
-f, --force delete Skip confirmation

Filtering

List commands accept --<field> filters. Check per-command help:

truto integrations list --help
truto accounts list --tenant-id <tid>
truto sync-jobs list --integration_name hubspot

Scripting examples

# IDs as JSON
truto integrations list -o json | jq '.[].id'
 
# Count exported records
truto export crm/contacts -a <account-id> -o ndjson | wc -l
 
# Debug HTTP
truto integrations list -v
# stderr: → GET https://api.truto.one/integration?limit=25
#         ← 200 OK

Stdin and --body

On create (admin resources), unified, proxy, custom, and batch:

  • Admin create: Input starting with [ → JSON array (bulk create); otherwise NDJSON (one object per line).
  • Data plane / batch: Stdin is always a single JSON body.
  • --stdin and -b are mutually exclusive. For data-plane commands, -b wins; for admin create, --stdin wins.

See Power features for full stdin examples.