Get Lifecycle Stage Details

JFrog REST APIs

Content Type
REST API

Description: Returns the details of a selected lifecycle stage, such as its scope and associated repositories.

Since: 7.125.4

Usage: GET https://{{artifactory-host}}/access/api/v2/stages/{{stage-name}}

Query Parameters (optional):

Parameter

Type

Description

project_key

string

Filters the list for a specific project.

Response Body:

Property

Type

Description

name

string

The stage name (must be unique within its scope).

scope

string

The scope of the stage (GLOBAL or PROJECT).

project_key

string

The project key (relevant when the scope is PROJECT).

category

string

The stage category (CODE or PROMOTE).

repositories

array:string

The list of repository keys assigned to this stage.

used_in_lifecycle

array:string

The list of project keys where the stage is being used in its lifecycle.

created_by

string

The user who created the stage.

created

string

The date and time when the stage was created (ISO 8601 format).

modified

string

The date and time when the stage was last modified (ISO 8601 format).

Sample Request:

GET 'https://{host}.jfrog.io/access/api/v2/stages/production-us-east?project_key=mobile-app'
Authorization: ••••••

Sample Response:

{
  "name": "production-us-east",
  "scope": "project",
  "project_key": "mobile-app",
  "category": "promote",
  "repositories": [
    "docker-prod-us-east-local",
    "generic-prod-us-east-local"
  ],
  "used_in_lifecycle": ["mobile-app"],
  "created_by": "pm_user",
  "created_at": "2025-05-28T17:51:25Z",
  "modified_at": "2025-05-28T17:59:25Z"
}

Status Codes:

Code

Description

200

Success

401

Bad Credentials

403

Permission Denied

404

Not Found