Help Center/ CodeArts Req/ API Reference/ API/ IPD Review Management/ Querying the Decision-maker of a Change Object (RR/Bug)
Updated on 2026-10-13 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Querying the Decision-maker of a Change Object (RR/Bug)

Function

This API is used to query the decision-maker of a change object (only RR/bug is supported) and is used to create a change review (the change object is RR/bug).

Calling Method

For details, see Calling APIs.

Authorization Information

Each account root user has all the permissions required to call all APIs, but IAM users must be assigned the following required identity policy-based permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

codeartsreq:configuration:get

Read

-

  • codeartsreq:Model

  • codeartsreq:ProjectId

-

-

URI

GET /v1/ipdprojectservice/projects/{project_id}/review/issues/{issue_id}/approvers

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

32-character ID of a project, which must be unique. Obtain the value by calling the API for querying the IPD project list. The value of id in the response message body is the project ID.

Constraints

N/A

Range

A string of 32 characters consisting of letters and digits.

Default Value

N/A

issue_id

Yes

String

Definition

Unique ID of a work item. You can obtain the value from the Querying Work Items or Querying Tree-shaped Work Items API. The value is id in the response body.

Constraints

N/A

Range

A string of 18 to 19 digits.

Default Value

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

status

String

Definition

Response status.

Range

  • success: The response is successful.

  • error: The response fails.

message

String

Request error message.

result

ReviewApproverListResult object

Decision-maker list
Table 3 ReviewApproverListResult

Parameter

Type

Description

data

Array of UserEntity objects

Decision-maker information

total

Integer

Total number of work item (RR/bug) decision-makers
Table 4 UserEntity

Parameter

Type

Description

id

String

Definition

User ID. Obtain it by calling the API for querying project members. The value of id in the response message body is the user ID.

Range

N/A

name

String

Definition

Username.

Range

2 to 64 characters.

nick_name

String

Definition

User alias.

Range

2 to 30 characters

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Definition

Error code.

Range

N/A

error_msg

String

Definition

Error description, which is a supplement to error_code.

Range

N/A

Example Requests

Querying the decision-maker of a change object

GET https://{endpoint}/v1/ipdprojectservice/projects/a75f1c34cbf24e5fbbbc154dd823cd8e/review/issues/1072841311153725441/approvers

Example Responses

Status code: 200

{
  "status" : "success",
  "result" : {
    "data" : [ {
      "id" : "a360371833bf4c558f796fd707b44daf",
      "name" : "devcloud_devcloud_01",
      "nick_name" : "Test account"
    } ],
    "total" : 1
  }
}

Status code: 400

{
  "error_code" : "PM.02174103",
  "error_msg" : "No permission."
}

Status Codes

Status Code

Description

200

OK

400

Response upon a request failure. For example, the user does not have the operation permission or the project does not exist.

Error Codes

See Error Codes.

Parent topic: IPD Review Management