Get Lifecycle Stages

Description: Returns a list of all stages with optional filtering.

Since: 7.125.4

Note

When no project_key is defined, this endpoint returns all global stages and is available to platform administrators only.

When a specific project_key is defined, this endpoint returns both global stages and the relevant project stages, and is available to project administrators for that project.

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

Query Parameters (optional):

Parameter	Type	Description
`project_key`	string	Filters the list of stages defined for a specific project.
`scope`	string	Filters the list by stage scope: `global` or `project`
`category`	string	Filters the list by stage category: `code` or `promote`

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 (scoped to the given project key when relevant).
`used_in_lifecycle`	array:string	The list of project keys where the stage is being used in its lifecycle (scoped to the given project key when relevant).
`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": "staging-us-east",
    "scope": "project",
    "project_key": "mobile-app",
    "category": "promote",
    "repositories": ["docker-staging-us-east-local"],
    "used_in_lifecycle": ["mobile-app"],
    "created_by": "admin",
    "created_at": "2025-05-27T11:00:00Z",
    "modified_at": "2025-05-27T11:00:00Z"
  },
  {
    "name": "PROD",
    "scope": "global",
    "project_key": "mobile-app",
    "category": "promote",
    "repositories": ["docker-staging-us-east-local"],
    "used_in_lifecycle": ["mobile-app"],
    "created_by": "system",
    "created_at": "2023-05-27T11:00:00Z",
    "modified_at": "2023-05-27T11:00:00Z"
  },
  {
    "name": "qa-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:51:25Z"
  }
]

Status Codes:

Code	Description
200	Success
401	Bad Credentials
403	Permission Denied