Help Center/ CodeArts Req/ API Reference/ API/ IPD Workflow/ Querying Workflow Field Configuration

Updated on 2025-07-01 GMT+08:00

Online Debugging

CLI Examples

View PDF

Querying Workflow Field Configuration

Function

This API is used to query workflow field configuration.

Calling Method

For details, see Calling APIs.

URI

GET /v1/ipdprojectservice/projects/{project_id}/workflow-template/issue/fields

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Description: 32-bit UUID of a project, which uniquely identifies a project. You can obtain the project ID by calling the API for querying the project list. The value of project_id in the response body is the project ID. Constraints: regular expression, ^[A-Za-z0-9]{32}$ Default value: N/A

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
issue_category	Yes	String	Definition: Work item type. Constraints: Regular expression: ^(RR\|IR\|AR\|SR\|Bug\|FE\|Task\|US\|Epic\|SF) Options: RR, IR, AR, SR, Bug, FE, Task, US, Epic, and SF Default value: N/A

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	Definition: User token. Obtain the token by calling theObtaining a User TokenIAM API. In the returned response header, X-Subject-Token is the desired user token. Constraints: Mandatory. Range: Minimum length: 10 character. Maximum length: 32,768 characters. Default value: N/A

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
result	Object	Definition: Query result. Options: N/A
status	String	Definition: Status code. Options: N/A
message	String	Definition: Response message. Options: N/A

Example Requests

GEThttps://{endpoint}/v1/ipdprojectservice/projects/39d30be0842e4e5d8e28ee7e1712c6a2/workflow-template/issue/fields?issue_category=RR

Example Responses

Status code: 200

Success response.

{
  "status" : "success",
  "message" : null,
  "result" : {
    "config_fields" : [ {
      "display_name" : "Turn-back Conclusion",
      "show" : false,
      "show_editable" : false,
      "optional" : true,
      "controlled" : false,
      "issue_roles" : null
    } ]
  }
}