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
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--management-key | -x | string | BT_MANAGEMENT_KEY env var | Management API key |
--page | -p | integer | 1 | Page 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
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--management-key | -x | string | BT_MANAGEMENT_KEY env var | Management API key |
--name | -n | string | (prompted) | Name of the Application |
--type | -t | string | (prompted) | Application type: private, public, or management |
--permission | -p | string[] | — | Permissions for the Application (repeatable) |
--template | -z | string | — | 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:write"
Create interactively (no flags):
bt applications create
Update Application
bt applications update <id>
Updates an existing Application.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | The Application ID to update |
Flags
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--management-key | -x | string | BT_MANAGEMENT_KEY env var | Management API key |
--name | -n | string | — | New name for the Application |
--permission | -p | string[] | — | 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
| Argument | Required | Description |
|---|---|---|
id | Yes | The Application ID to delete |
Flags
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--management-key | -x | string | BT_MANAGEMENT_KEY env var | Management API key |
--yes | -y | boolean | false | Skip confirmation prompt |
Required Permissions
application:delete
Example
bt applications delete 03858bf5-32d3-4a2e-b74b-daeea0883bca -y