> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexprice.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Global flags

> Flags accepted by every Flexprice CLI command, grouped by what they control

Every command accepts the flags below. They can appear anywhere in the invocation.

```sh theme={null}
flexprice [global flags] <resource> <action> [command flags]
```

## Targeting

Which account, environment, and endpoint the command talks to.

| Flag                   | Description                                                                                     |
| ---------------------- | ----------------------------------------------------------------------------------------------- |
| `-p, --profile <name>` | Use a specific stored profile for this command, instead of the default.                         |
| `--region <key>`       | Region to target, e.g. `us` or `in`.                                                            |
| `--base-url <url>`     | Override the API base URL outright. Takes precedence over `--region`.                           |
| `--api-key <key>`      | Use this key instead of a stored one. Intended for CI — prefer `flexprice login` interactively. |

See [Authentication](/docs/cli/authentication) for how these resolve against each other and against stored profiles.

<Warning>
  A key passed with `--api-key` does not identify a region on its own. Pair it with `--region` or `--base-url`, or the command stops and tells you rather than guessing.
</Warning>

## Output

How results are formatted and how much commentary you get.

| Flag                | Description                                                                 |
| ------------------- | --------------------------------------------------------------------------- |
| `--output <format>` | `table` (default), `json`, or `yaml`. Use `json` for anything machine-read. |
| `--columns <list>`  | Restrict table output to specific columns.                                  |
| `--no-color`        | Disable colour. Status icons (`✓ ✗ ⚠`) remain.                              |
| `--quiet`           | Suppress progress and commentary. Results and errors still print.           |

Colour is also disabled automatically when `NO_COLOR` is set, when `TERM=dumb`, and whenever stderr is not a terminal — so CI logs stay clean without passing anything.

## Pagination

| Flag          | Description                                      |
| ------------- | ------------------------------------------------ |
| `--limit <n>` | Maximum records to return. Defaults to `20`.     |
| `--all`       | Page through every record. Prints the last page. |

<Note>
  For bulk export, combine `--output json` with `--limit` rather than reaching for `--all` — `--all` prints only the final page, which is rarely what an export wants.
</Note>

## Automation

| Flag         | Description                                                         |
| ------------ | ------------------------------------------------------------------- |
| `--no-input` | Never prompt. Fails with a message naming the flag to pass instead. |
| `--debug`    | Dump requests and responses. Secrets are redacted.                  |

`--no-input` is what you want in a non-interactive environment where a hung prompt would stall the job: instead of waiting for an answer nobody can give, the command fails immediately and tells you which flag would have supplied it.

## Informational

| Flag            | Description                                                                      |
| --------------- | -------------------------------------------------------------------------------- |
| `-h, --help`    | Help for the command. Works at every level: `flexprice customers create --help`. |
| `-v, --version` | Print the CLI version and the embedded spec build.                               |

## Not global: `--force`

`--force` skips the confirmation prompt on destructive actions, but it is declared **per command**, not on the root. It has to come after the resource and action:

```sh theme={null}
flexprice customers delete cust_123 --force     # correct
flexprice --force customers delete cust_123     # wrong
```

Passing it earlier makes the CLI read the resource name as the flag's value and report a confusing error about the action instead.

## Next steps

<CardGroup cols={2}>
  <Card icon="code" title="Output & scripting" href="/docs/cli/output-and-scripting">
    Exit codes and the stdout/stderr contract.
  </Card>

  <Card icon="key" title="Authentication" href="/docs/cli/authentication">
    Profiles, regions, and credential precedence.
  </Card>
</CardGroup>