Create Lifecycle Stage

Description: Creates a new global or project-level lifecycle stage.

Since: 7.125.4

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

Consumes: application/json

Request Body:

Parameter	Required/Optional	Type	Description
`name`	required	string	The unique name of the stage (for example, `DEV`, `QA`, `PROD`).
`project_key`	optional	string	The project key associated with the stage. If left undefined, the stage is defined as a global stage that can be used by all projects.
`category`	optional	string	The category of the stage: `none` `promote` (default)

Parameter

Required/Optional

Type

Description

name

required

string

The unique name of the stage (for example, DEV, QA, PROD).

project_key

optional

string

The project key associated with the stage.

If left undefined, the stage is defined as a global stage that can be used by all projects.

category

optional

string

The category of the stage:

none
promote (default)

Response Body:

In addition to the properties inside the request body, the response includes the following information:

Property	Type	Description
`used_in_lifecycle`	boolean	Lists the project keys that use this stage as part of its lifecycle.
`created_by`	string	The user ID who created the stage.
`created`	string	The date and time when the stage was created (ISO 8601 format).

Sample Request:

POST 'https://{host}.jfrog.io/access/api/v2/stages/
Content-Type: application/json
Authorization: ••••••

{
  "name": "production-us-east",
  "scope": "project",
  "project_key": "mobile-app",
  "category": "promote",
  "repositories": ["docker-prod-us-east-local", "generic-prod-us-east-local"]
}

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": false,
  "created_by": "pm_user",
  "created_at": "2025-05-28T17:51:25Z",
  "modified_at": "2025-05-28T17:59:25Z"
}

Status Codes:

Code	Description
201	Success
400	Bad Request
401	Bad Credentials
403	Permission Denied
409	Conflict