locations Commands | BCTRL Docs

Manage locations

Output formatting flags (--json, --jq, and --template) are documented once in Output Formatting and are omitted from the tables below.

`bctrl locations list`

List deployed compute locations and current admission availability. Runtime location auto resolves to an allowed live location; homeRegions identifies compatible data homes. Catalog entries are ordered by their immutable ID.

bctrl locations list [flags]

Flag	Description
`--query <json>`	Query object: inline JSON, @file, or - for stdin
`--params <json>`	Alias for —query
`--cursor <value>`	Query parameter cursor
`--order <value>`	Query parameter order
`--limit <value>`	Query parameter limit
`--headers <json>`	API headers: inline JSON, @file, or - for stdin
`--api-version <date>`	Dated API contract (default: 2026-10-03)
`--space <id-or-name>`	Select an authorized Space (BCTRL-Space)
`--subaccount-id <id>`	Effective subaccount context (BCTRL-Subaccount-Id)