Retrieves all pending change requests referencing a feature in the project

GET <your-unleash-url>/api/admin/projects/:projectId/change-requests/pending/:featureName

Authorization

name: Authorizationtype: apiKeyin: headerdescription: API key needed to access this API

This endpoint will retrieve all pending change requests (change requests with a status of Draft | In review | Approved) referencing the given feature toggle name.

Request

Path Parameters

• projectId string required
• featureName string required

Responses

• 200

---

changeRequestsSchema

application/json

Schema

Schema

• Array [
oneOf

MOD1

id number required

This change requests's ID.

title string

A title describing the change request's content.

environment string required

The environment in which the changes should be applied.

minApprovals number required

The minimum number of approvals required before this change request can be applied.

project string required

The project this change request belongs to.

features object[]required

The list of features and their changes that relate to this change request.

Array [

name string required

The name of the feature

conflict string

A string describing the conflicts related to this change. Only present if there are any concflicts on the feature level.

changes object[]required

List of changes inside change request. This list may be empty when listing all change requests for a project.

Array [

id number required

The ID of this change.

action string required

The kind of action that the change contains information about.

conflict string

A description of the conflict caused by this change. Only present if there are any conflicts.

payload objectrequired

The data required to perform this action.

oneOf

MOD1

string

MOD2

boolean

MOD4

number

setStrategySortOrderSchema

Array [

id string required

The ID of the strategy

sortOrder number required

The new sort order of the strategy

]

createdBy object

The user who created this change.

username string nullable

The user's username.

imageUrl uri nullable

The URL where the user's image can be found.

createdAt date-time

When this change was suggested

]

defaultChange object

A description of a default change that will be applied with the change request to prevent invalid states.

Default changes are changes that are applied in addition to explicit user-specified changes when a change request is applied. Any default changes are applied in the background and are not a real part of the change request.

action string required

The kind of action this is.

payload object required

The necessary data to perform this change.

]

segments object[]required

The list of segments and their changes that relate to this change request.

Array [

id number required

The ID of this change.

action string required

The kind of action that the change contains information about.

conflict string

A description of the conflict caused by this change. Only present if there are any conflicts.

payload objectrequired

The data required to perform this action.

oneOf

MOD1

string

MOD2

boolean

MOD4

number

setStrategySortOrderSchema

Array [

id string required

The ID of the strategy

sortOrder number required

The new sort order of the strategy

]

createdBy object

The user who created this change.

username string nullable

The user's username.

imageUrl uri nullable

The URL where the user's image can be found.

createdAt date-time

When this change was suggested

name string required

The current name of the segment

]

approvals object[]

A list of approvals that this change request has received.

Array [

createdBy objectrequired

Information about the user who gave this approval.

id number

The ID of the user who gave this approval.

username string

The approving user's username.

imageUrl uri

The URL where the user's image can be found.

createdAt date-time required

When the approval was given.

]

rejections object[]

A list of rejections that this change request has received.

Array [

createdBy objectrequired

Information about the user who gave this approval.

id number

The ID of the user who gave this approval.

username string

The approving user's username.

imageUrl uri

The URL where the user's image can be found.

createdAt date-time required

When the approval was given.

]

comments object[]

All comments that have been made on this change request.

Array [

id number

The comment's ID. Unique per change request.

text string required

The content of the comment.

createdBy objectrequired

Information about the user who posted the comment

username string nullable

The user's username.

imageUrl uri nullable

The URL where the user's image can be found.

createdAt date-time required

When the comment was made.

]

createdBy objectrequired

The user who created this change request.

username string nullable

imageUrl uri nullable

The URL of the user's profile image.

createdAt date-time required

When this change request was created.

state string required

Possible values: [Draft, In review, Approved, Applied, Cancelled, Rejected]

The current state of the change request.

MOD2

id number required

This change requests's ID.

title string

A title describing the change request's content.

environment string required

The environment in which the changes should be applied.

minApprovals number required

The minimum number of approvals required before this change request can be applied.

project string required

The project this change request belongs to.

features object[]required

The list of features and their changes that relate to this change request.

Array [

name string required

The name of the feature

conflict string

A string describing the conflicts related to this change. Only present if there are any concflicts on the feature level.

changes object[]required

List of changes inside change request. This list may be empty when listing all change requests for a project.

Array [

id number required

The ID of this change.

action string required

The kind of action that the change contains information about.

conflict string

A description of the conflict caused by this change. Only present if there are any conflicts.

payload objectrequired

The data required to perform this action.

oneOf

MOD1

string

MOD2

boolean

MOD4

number

setStrategySortOrderSchema

Array [

id string required

The ID of the strategy

sortOrder number required

The new sort order of the strategy

]

createdBy object

The user who created this change.

username string nullable

The user's username.

imageUrl uri nullable

The URL where the user's image can be found.

createdAt date-time

When this change was suggested

]

defaultChange object

A description of a default change that will be applied with the change request to prevent invalid states.

Default changes are changes that are applied in addition to explicit user-specified changes when a change request is applied. Any default changes are applied in the background and are not a real part of the change request.

action string required

The kind of action this is.

payload object required

The necessary data to perform this change.

]

segments object[]required

The list of segments and their changes that relate to this change request.

Array [

id number required

The ID of this change.

action string required

The kind of action that the change contains information about.

conflict string

A description of the conflict caused by this change. Only present if there are any conflicts.

payload objectrequired

The data required to perform this action.

oneOf

MOD1

string

MOD2

boolean

MOD4

number

setStrategySortOrderSchema

Array [

id string required

The ID of the strategy

sortOrder number required

The new sort order of the strategy

]

createdBy object

The user who created this change.

username string nullable

The user's username.

imageUrl uri nullable

The URL where the user's image can be found.

createdAt date-time

When this change was suggested

name string required

The current name of the segment

]

approvals object[]

A list of approvals that this change request has received.

Array [

createdBy objectrequired

Information about the user who gave this approval.

id number

The ID of the user who gave this approval.

username string

The approving user's username.

imageUrl uri

The URL where the user's image can be found.

createdAt date-time required

When the approval was given.

]

rejections object[]

A list of rejections that this change request has received.

Array [

createdBy objectrequired

Information about the user who gave this approval.

id number

The ID of the user who gave this approval.

username string

The approving user's username.

imageUrl uri

The URL where the user's image can be found.

createdAt date-time required

When the approval was given.

]

comments object[]

All comments that have been made on this change request.

Array [

id number

The comment's ID. Unique per change request.

text string required

The content of the comment.

createdBy objectrequired

Information about the user who posted the comment

username string nullable

The user's username.

imageUrl uri nullable

The URL where the user's image can be found.

createdAt date-time required

When the comment was made.

]

createdBy objectrequired

The user who created this change request.

username string nullable

imageUrl uri nullable

The URL of the user's profile image.

createdAt date-time required

When this change request was created.

state string required

Possible values: [Scheduled]

The current state of the change request.

schedule objectrequired

A schedule for a change request's application. The schedule can either be pending, failed, or suspended. The schedule will always contain the state of the schedule and the last scheduled time, but other data varies between the different states.

oneOf

MOD1

scheduledAt date-time required

When this change request will be applied.

status string required

Possible values: [pending]

The status of the schedule.

MOD2

scheduledAt date-time required

When Unleash last attempted to apply this change request.

status string required

Possible values: [failed]

The status of the schedule.

reason string required

The reason the scheduled failed to apply.

failureReason string nullable deprecated

The reason the scheduled failed to apply. Deprecated in favor of the reason property.

MOD3

scheduledAt date-time required

When Unleash would have attempted to apply this change request if the schedule was not suspended.

status string required

Possible values: [suspended]

The status of the schedule.

reason string required

Why the schedule was suspended.

• ]

Example (from schema)

[
  null,
  null
]

Authorization

name: Authorizationtype: apiKeyin: headerdescription: API key needed to access this API

Request

Base URL

<your-unleash-url>

Security Scheme

apiKeybearerToken

apiKey

projectId — path required

featureName — path required

curl / cURL

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/change-requests/pending/:featureName' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

python / requests

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/change-requests/pending/:featureName' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

go / native

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/change-requests/pending/:featureName' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

nodejs / axios

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/change-requests/pending/:featureName' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

ruby / Net::HTTP

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/change-requests/pending/:featureName' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

csharp / RestSharp

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/change-requests/pending/:featureName' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

php / cURL

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/change-requests/pending/:featureName' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

java / OkHttp

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/change-requests/pending/:featureName' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

powershell / RestMethod

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/change-requests/pending/:featureName' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'