Update Application Version CLI

Description: Updates the tag and/or properties of the specified application version. You can set or replace values for specific property keys.

Command:

jf apptrust version-update <app-key> <version> --tag "<tag>" --properties "<key>=<value1>[,<value2>,...]" --delete-properties "<key1>;<key2>"

Alias command: jf at vu

Command Options

Option	Required/Optional	Type	Description
`<app-key>`	required	string	The application key of the application whose version is being updated.
`<version>`	required	string	The application version number.
`--tag "<tag>"`	optional	string	A free-text tag to associate with the version. The tag is limited to 255 characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics in between.
`--properties "<key>=<value1>[,<value2>,...]"`	optional	object	Sets or updates custom properties for the application version. Each key is a property name (string) and its value is an array representing values for that property. Providing a key with an array of strings replaces any existing values for that specific key. Providing a key with an empty array (`[]`) clears all values for that key, but the key itself remains. Property keys not included in this object are not affected.
`--delete-properties "<key1>;<key2>"`	optional	array:string	Removes the specified property keys and all their associated values from the application version. Provide a semicolon-separated (`;`) list of keys.

Example 1: Update an application version

This command updates an application version with a new tag.

jfrog apptrust version-update my-auth-service 1.2.0 --tag="release-candidate"

Example 2: Remove a property key from an application version

This command removes a property key and its associated values from the application version.

jf at vu my-auth-service 1.2.0 --delete-properties="site"

Frequently Asked Questions

Common questions about updating an application version.

plusFAQs

Q: How do I update an application version's tag using the JFrog CLI?

A: Run jf apptrust version-update <app-key> <version> --tag "<tag>" (alias jf at vu). See Example 1.

Q: What happens if I provide a property key with an empty array?

A: Passing an empty array ([]) for a property key clears all values for that key, but the key itself remains on the application version.

Q: Can I remove a property key entirely instead of clearing its values?

A: Yes. Use --delete-properties with a semicolon-separated list of keys to remove those keys and all their associated values. See Example 2.

Q: What is the character limit for a version tag?

A: A tag is limited to 255 characters. It must begin and end with an alphanumeric character, with dashes, underscores, dots, and alphanumerics allowed in between.