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-zstringTemplate 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:write"

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-nstringNew 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