Try JFrog
Guides
Contact SupportTry JFrog
  1. CLI
  2. AppTrust CLI
  3. Application CLI Commands

Update Application CLI

Update details of an existing application in JFrog AppTrust.

Description: Updates the definition of the specified application with new data. The application key and project key can't be changed after the application is created.

📘

Note

The application_key and project_key cannot be modified.

Command:

jf apptrust app-update <app-key> [command options]

Alias command: jf at au

Command Parameters

OptionRequired/OptionalTypeDescription
<application-key>requiredstringThe application key. Must be 2-64 lowercase alphanumeric characters, beginning with a letter (hyphens are supported). The key must be unique and immutable.
--application-name "<application-name>"optionalstring

The application display name. Must be a unique string within the scope of the project, 1-255 alphanumeric characters in length, including underscores, hyphens, and spaces.

If this option is not provided, the app-key is used as the display name.

--desc "<description>"optionalstringFree-text description of the application.
--business-criticality "<level>"optionalstringA classification of how critical the application is for your business:
  • unspecified (default)
  • low
  • medium
  • high
  • critical
--maturity-level "<level>"optionalstringThe maturity level of the application:
  • unspecified
  • experimental
  • production
  • end_of_life
--labels "<key1>=<value1>; <key2>=<value2>"optionalarray:string

Key-value pairs for labeling the application. Each key and value is free text, limited to 255 characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics in between.

Each label must be specified as key=value. A bare key without = is rejected.

Replaces the full label set. Use --add-labels and --remove-labels to modify labels incrementally instead.

Sample labels: tier=frontend, release=canary, and AppGroup=wordpress.

--add-labels "<key1>=<value1>; <key2>=<value2>"optionalarray:stringKey-value pairs to add to the application's existing label set, without affecting other labels. Same format as --labels.
--remove-labels "<key1>=<value1>; <key2>=<value2>"optionalarray:stringKey-value pairs to remove from the application's existing label set. Same format as --labels.
--user-owners "<user-owner1>; <user-owner2>"optionalarray:stringList of users defined in the project who own the application.
--group-owners "<group-owner1>; <group-owner2>"optionalarray:stringList of user groups defined in the project who own the application.

Sample command:

jf apptrust app-update myapp-001 --labels "tier=frontend; release=production"

Frequently Asked Questions

Common questions about updating an application.

plusFAQs
Q: How do I update an application using the JFrog CLI?

A: Run jf apptrust app-update <app-key> [command options] (alias jf at au) with the options for the fields you want to change. See Command Parameters.

Q: Can I change an application's key or project after creation?

A: No. application_key and project_key can't be modified after the application is created.

Q: What's the difference between --labels and --add-labels/--remove-labels?

A: --labels replaces the entire label set, while --add-labels and --remove-labels modify the existing set incrementally without affecting other labels.

Q: What happens if I don't provide --application-name?

A: The CLI uses the app-key as the display name, the same default behavior described for this option in Command Parameters.

Related Topics

Updated 2 days ago

Did this page help you?