Update Application

JFrog REST APIs

Content Type
REST API

Description: Updates the definition of the specified application with new data. All fields in the body are optional, which means that only the fields included in the request body will be replaced.

Note

The application_key and project_key cannot be modified.

Since: AppTrust 1.16.4

Usage: PATCH https://{{artifactory-host}}/apptrust/v1/applications/{application_key}

Consumes: application/json

Request Body:

Parameter

Type

Description

application_name

string

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.

description

string

A free text description of the application.

maturity

string

The maturity level of the application:

  • unspecified

  • experimental

  • production

  • end_of_life

criticality

string

A classification of how critical the application is for your business: (unspecified, low, medium, high, critical).

  • unspecified (default)

  • low

  • medium

  • high

  • critical

labels

array: 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.

If provided, each label must have a key (mandatory), with the value being optional.

user_owners

array: string

List of users defined in the project who own the application.

group_owners

array: string

List of user groups defined in the project who own the application.

Sample Request:

PATCH 'https://{host}.jfrog.io/apptrust/api/v1/catalina_app?project=catalina'
Content-Type: application/json
Authorization: ••••••

{
    "application_name": "Catalina-App",
    "description": "This application contains enhancements to login performance.",
    "maturity": "production",
    "criticality": "low",
    "labels": {
        "environment": "production",
        "region": "us-east"
    },
    "user-owners": { 
        "JohnD", 
        "Dave Rice", 
        "Alina Hood" 
    },
    "group_owners": { 
        "DevOps", 
        "Platform Admins" 
    }
}

Sample Response:

Same as the request above.

Status Codes:

Code

Description

200

Success

400

Bad Request

403

Permission Denied