Skip to main content

Applications

Commands for managing Applications.

List Applications​

bt applications

Lists all Applications in your tenant with pagination. When run interactively, selecting an Application provides options to view its details.

Flags​

FlagShortTypeDefaultDescription
--management-key-xstringBT_MANAGEMENT_KEY env varManagement API key
--page-pinteger1Page number to fetch

Required Permissions​

application:read

Example​

bt applications -p 2

Create Application​

bt applications create

Creates a new Application. When flags are omitted, the CLI will interactively prompt for required values.

Flags​

FlagShortTypeDefaultDescription
--management-key-xstringBT_MANAGEMENT_KEY env varManagement API key
--name-nstring(prompted)Name of the Application
--type-tstring(prompted)Application type: private, public, or management
--permission-pstring[]—Permissions for the Application (repeatable)
--template-zstring—Template ID to create the Application from
When --template is provided, the Application is created from the template and no permissions need to be specified. Otherwise, the CLI prompts for permissions based on the selected type.

Required Permissions​

application:create

Examples​

Create with flags:

bt applications create \
-n "My Application" \
-t private \
-p "token:read" \
-p "token:create"

Create interactively (no flags):

bt applications create

Update Application​

bt applications update <id>

Updates an existing Application.

Arguments​

ArgumentRequiredDescription
idYesThe Application ID to update

Flags​

FlagShortTypeDefaultDescription
--management-key-xstringBT_MANAGEMENT_KEY env varManagement API key
--name-nstring—New name for the Application
--permission-pstring[]—Updated permissions (repeatable)

Required Permissions​

application:update

Example​

bt applications update 03858bf5-32d3-4a2e-b74b-daeea0883bca \
-n "Renamed Application" \
-p "token:read"

Delete Application​

bt applications delete <id>

Deletes an Application. By default, the CLI will prompt for confirmation before deleting.

Arguments​

ArgumentRequiredDescription
idYesThe Application ID to delete

Flags​

FlagShortTypeDefaultDescription
--management-key-xstringBT_MANAGEMENT_KEY env varManagement API key
--yes-ybooleanfalseSkip confirmation prompt

Required Permissions​

application:delete

Example​

bt applications delete 03858bf5-32d3-4a2e-b74b-daeea0883bca -y