spaces Commands
Manage spaces
Output formatting flags (--json, --jq, and --template) are documented once in Output Formatting and are omitted from the tables below.
bctrl spaces create
Create a space. Name, region, and environment are optional; omitted values use server defaults.
bctrl spaces delete
Delete a Space and everything in it: its browsers and sandboxes are stopped and destroyed, and its agents, Tasks, Conversations, files and views deleted. Run records, usage and Events stay with the organization. The deletion runs in the background; the Space shows status deleting until it is gone. Pass wait to block until then.
bctrl spaces get
Get one complete space, including its environment.
bctrl spaces list
List complete spaces visible to the current API key.
bctrl spaces spendingCap get
Read this Space’s UTC calendar-month limit and accrued usage in USD cents. Both the organization and Space limits apply. Warning occurs once per month at 80%; at 100%, running work is stopped within at most one minute of additional usage.
bctrl spaces spendingCap update
People may set this Space’s whole-cent USD limit; null disables it and zero refuses new billable starts here. Other Spaces are unaffected. Raising it allows starts when both this limit and the organization limit exceed current usage.
bctrl spaces update
Update a space name or environment.