Help Center/ CodeArts Req/ API Reference/ API/ Scrum Project Work Items/ Updating a Work Item

Updated on 2026-10-27 GMT+08:00

Updating a Work Item

Function

This API is used to update a work item.

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:workitem:update	Write	-	codeartsreq:Model codeartsreq:ProjectId	-	-

URI

PUT /v4/projects/{project_id}/issues/{issue_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition A 32-character UUID. It uniquely identifies a project. Obtain a project ID by calling the API for querying projects. The value of project_id in the response message body is a project ID. Constraints A string of 32 characters consisting of letters and digits. Range N/A Default Value N/A
issue_id	Yes	Integer	Definition Work item ID, which can be obtained from the API for performing advanced query of work items. The value of the id field in the response body is the work item ID. Constraints N/A Range ≥ 0 Default Value N/A

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
actual_work_hours	No	Double	Definition: Actual workloads. Constraints: N/A Options: Minimum value: 0. Default value: N/A
assigned_id	No	Integer	Definition Digital ID of the handler. You can obtain the digital ID of a user in a specified project using the API for obtaining the user list of a specified project. Constraints ≥ 1 digit Range Min.: 0. Default Value N/A
begin_time	No	String	Definition: Start time. The format is YYYY-MM-DD. Constraints: N/A Options: N/A Default value: N/A
description	No	String	Definition: Description. Constraints: N/A Options: N/A Default value: N/A
developer_id	No	Integer	Definition Developer ID. Constraints ≥ 1 digit Range Min.: 0. Default Value N/A
domain_id	No	Integer	Definition Domain ID. Constraints ≥ 1 digit Range Min.: 0. Default Value N/A
done_ratio	No	Integer	Definition Work item completion percentage. For example, 20 indicates a completion of 20%. Constraints The value is a number ranging from 0 to 100. Range 0–100 Default Value N/A
end_time	No	String	Definition: End time. The format is YYYY-MM-DD. Constraints: N/A Options: N/A Default value: N/A
expected_work_hours	No	Double	Definition: Estimated workloads. Constraints: N/A Options: Minimum value: 0. Default value: N/A
iteration_id	No	Integer	Definition Sprint ID. Constraints ≥ 1 digit Range Min.: 0. Default Value N/A
module_id	No	Integer	Definition Module ID. Constraints ≥ 1 digit Range Min.: 0. Default Value N/A
name	No	String	Definition: Title. Constraints: N/A Options: N/A Default value: N/A
new_custom_fields	No	Array of NewCustomField objects	Definition: Custom fields of a Scrum work item. You can obtain custom fields of a Scrum work item using the Querying Custom Fields of a Scrum Work Item API. Constraints: N/A Options: N/A Default value: N/A
parent_issue_id	No	Integer	Definition Parent work item ID. Constraints ≥ 1 digit Range Min.: 0. Default Value N/A
priority_id	No	Integer	Definition Priority. The options are as follows: 1: low 2: medium 3: high Constraints ≥ 1 digit Range 1, 2, 3 Default Value N/A
severity_id	No	Integer	Definition Severity. The options are as follows: 10: critical 11: major 12: minor 13: info Constraints ≥ 1 digit Range 10, 11, 12, 13 Default Value N/A
status_id	No	Integer	Definition Status ID. The options are as follows: 1: new 2: developing 3: resolved 4: testing 5: closed 6: rejected Constraints ≥ 1 digit Range 1, 2, 3, 4, 5, 6 Default Value N/A
tracker_id	No	Integer	Definition Work item type. The options are as follows: 2 (task) 3 (bug) 5 (epic) 6 (feature) 7 (story) Constraints ≥ 1 digit Range 2, 3, 5, 6, 7 Default Value N/A

**Table 3** NewCustomField
Parameter	Mandatory	Type	Description
custom_field	No	String	Parameter description: Custom field. You can obtain the custom_field value returned using the [Querying Custom Fields of a Scrum Work Item]ListIssueCustomFields.xml) API. Constraints: This field can be left blank. Options: N/A Default value: N/A
field_name	No	String	Definition: Values of custom properties. Use commas (,) to separate multiple values, which can be obtained by querying the name value returned when calling the Querying Custom Fields of a Scrum Work Item API. Constraints: This field can be left blank. Value range: N/A Default value: N/A
value	No	String	Definition: Values of custom properties. Use commas (,) to separate multiple values. You can obtain the value by querying the options value returned when calling the Querying Custom Fields of a Scrum Work Item API. Constraints: This field can be left blank. Value range: N/A Default value: N/A

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
actual_work_hours	Double	Definition Actual workloads. Range ≥ 0
assigned_cc_user	Array of IssueUser objects	Parameter description: Cc recipient.
assigned_user	IssueUser object	Parameter description: Handler.
begin_time	String	Parameter description: Estimated start time. The format is YYYY-MM-DD. Value range: N/A
closed_time	String	Definition: Closing time. The format is YYYY-MM-DD. Value range: N/A
created_time	String	Parameter description: Creation time. The format is YYYY-MM-DD HH:MM:SS. Value range: N/A
creator	IssueUser object	Parameter description: Creator.
custom_fields	Array of CustomField objects	Parameter description: Custom property value, which is not recommended. Refer to the new_custom_fields field.
developer	IssueUser object	Parameter description: Developer.
domain	domain object	Definition: Domain.
done_ratio	Integer	Definition Work item completion rate. For example, 20 indicates that the completion rate is 20%. Range 0–100
end_time	String	Definition Estimated end time. The format is YYYY-MM-DD. Range N/A
expected_work_hours	Double	Definition Estimated workloads. Range Min.: 0.
id	Integer	Definition Work item ID. Range ≥ 0
iteration	iteration object	Definition Sprint.
module	module object	Definition Module.
name	String	Definition: Title. Options: N/A
new_custom_fields	Array of NewCustomField objects	Definition: Custom property value.
parent_issue	parent_issue object	Definition: Parent work item.
priority	priority object	Definition: Work item priority.
project	IssueProjectResponseV4 object	Definition: Project information.
severity	severity object	Definition: Work item severity.
status	status object	Definition: Work item status.
tracker	tracker object	Definition: Work item type.
updated_time	String	Definition: Update time. The format is YYYY-MM-DD HH:MM:SS. Options: N/A
find_release_dev	String	Definition Version number. Range N/A
release_dev	String	Definition Release version number. Range N/A
env	IssueAttribute object	Definition Environment. Range N/A
tag_list	Array of TagRelation objects	Definition Tag list. Range N/A

**Table 5** IssueUser
Parameter	Type	Description
id	Integer	Definition User ID. Range N/A
name	String	Definition Username. Range N/A
nick_name	String	Definition: Alias. Options: N/A
user_id	String	Definition User UUID. Range N/A
user_num_id	Integer	Definition Digital ID of a user. Range N/A
first_name	String	Definition: Username. Value range: N/A

**Table 6** CustomField
Parameter	Type	Description
name	String	Definition: Custom property name. Value range: N/A
new_name	String	Definition: Custom property name. Value range: N/A
value	String	Definition: Value of the custom property. Value range: N/A

**Table 7** domain
Parameter	Type	Description
id	Integer	Definition: Domain ID. The options are as follows: 14: performance 15: performance 16: reliability 17: cyber security 18: maintainability 19: other DFX 20: availability Value range: 14, 15, 16, 17, 18, 19, and 20
name	String	Definition: Domain name. Options: N/A

**Table 8** iteration
Parameter	Type	Description
id	Integer	Definition Sprint ID. Range ≥ 0
name	String	Definition: Sprint name. Options: N/A

**Table 9** module
Parameter	Type	Description
id	Integer	Definition Module ID. Range ≥ 0
name	String	Definition: Module. Options: N/A

**Table 10** NewCustomField
Parameter	Type	Description
custom_field	String	Parameter description: Custom field. You can obtain the custom_field value returned using the [Querying Custom Fields of a Scrum Work Item]ListIssueCustomFields.xml) API.
field_name	String	Definition: Values of custom properties. Use commas (,) to separate multiple values, which can be obtained by querying the name value returned when calling the Querying Custom Fields of a Scrum Work Item API.
value	String	Definition: Values of custom properties. Use commas (,) to separate multiple values. You can obtain the value by querying the options value returned when calling the Querying Custom Fields of a Scrum Work Item API.

**Table 11** parent_issue
Parameter	Type	Description
id	Integer	Definition Parent work item ID. Range Min.: 0.
name	String	Definition: Parent work item. Options: N/A

**Table 12** priority
Parameter	Type	Description
id	Integer	Definition Priority ID. The options are as follows: 1: low 2: medium 3: high Range 1: low 2: medium 3: high
name	String	Definition Priority. Range Low Medium High

**Table 13** IssueProjectResponseV4
Parameter	Type	Description
project_id	String	Definition Project ID. Range N/A
project_name	String	Definition: Project name. Value range: N/A
project_num_id	Integer	Definition Digital ID of a project. Range ≥ 0

**Table 14** severity
Parameter	Type	Description
id	Integer	Definition: Severity ID. The options are as follows: 10: critical 11: major 12: minor 13: info Options: 10, 11, 12, and 13
name	String	Definition: Severity. Options: N/A

**Table 15** status
Parameter	Type	Description
id	Integer	Definition: Status ID. The options are as follows: 1: initial 2: in progress 3: solved 4: testing 5: closed 6: rejected Options: 1, 2, 3, 4, 5, and 6
name	String	Definition: Status name. Options: N/A

**Table 16** tracker
Parameter	Type	Description
id	Integer	Definition: Type ID. The options are as follows: 2 (task) 3 (bug) 5 (epic) 6 (feature) 7 (story) Options: 2, 3, 5, 6, and 7
name	String	Definition: Type name. Options: N/A

**Table 17** IssueAttribute
Parameter	Type	Description
id	Integer	Definition Environment ID. Range N/A
name	String	Definition Environment name. Range N/A

**Table 18** TagRelation
Parameter	Type	Description
relationId	Integer	Definition Association ID. Range N/A
tagId	Integer	Definition Tag ID. Range N/A
region	String	Definition Region. Range N/A
name	String	Definition Tag name. Range N/A

Status code: 400

**Table 19** Response body parameters
Parameter	Type	Description
error_code	String	Definition: Error code. Value range: N/A
error_msg	String	Definition: Error description. Value range: N/A

Status code: 401

**Table 20** Response body parameters
Parameter	Type	Description
error_code	String	Definition: Error code. Value range: N/A
error_msg	String	Definition: Error description. Value range: N/A
request_id	String	Definition Request ID, which is automatically generated by the system. Range N/A

Example Requests

PUT https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/issues/4568921

{
  "status_id" : 2
}

Example Responses

Status code: 200

{
  "id" : 1377841,
  "name" : "testAPI modification",
  "done_ratio" : 0,
  "tracker" : {
    "id" : 3,
    "name" : "Bug"
  },
  "priority" : {
    "id" : 2,
    "name" : "Medium"
  },
  "security_level" : null,
  "order" : {
    "id" : 1,
    "name" : "1"
  },
  "severity" : {
    "id" : 12,
    "name" : "Minor"
  },
  "status" : {
    "id" : 1,
    "name" : "Initial"
  },
  "release_dev" : "",
  "find_release_dev" : "",
  "env" : null,
  "updated_time" : "2026-07-08 14:23:25",
  "begin_time" : "2025-12-17",
  "end_time" : "2025-12-31",
  "project" : {
    "project_num_id" : 527,
    "project_id" : "ddb260aa69b848599747eadfa632a40f",
    "project_name" : "Scrum0630001"
  },
  "parent_issue" : {
    "id" : 1377839,
    "name" : "story111"
  },
  "module" : null,
  "domain" : null,
  "iteration" : null,
  "story_point" : null,
  "expected_work_hours" : 0,
  "actual_work_hours" : 0,
  "created_time" : "2026-06-30 16:57:45",
  "custom_fields" : [ ],
  "new_custom_fields" : null,
  "assigned_cc_user" : null,
  "assigned_user" : {
    "user_id" : null,
    "user_num_id" : null,
    "id" : 83,
    "name" : "CodeArtsReq_creq_chm1",
    "nick_name" : "creq_chm1",
    "first_name" : "creq_chm1"
  },
  "creator" : {
    "user_id" : null,
    "user_num_id" : null,
    "id" : 83,
    "name" : "CodeArtsReq_creq_chm1",
    "nick_name" : "creq_chm1",
    "first_name" : "creq_chm1"
  },
  "developer" : {
    "user_id" : null,
    "user_num_id" : null,
    "id" : 83,
    "name" : "CodeArtsReq_creq_chm1",
    "nick_name" : null,
    "first_name" : "creq_chm1"
  },
  "closed_time" : null,
  "tag_list" : null
}

SDK Sample Code

The SDK sample code is as follows.

Java

     package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.projectman.v4.region.ProjectManRegion;
import com.huaweicloud.sdk.projectman.v4.*;
import com.huaweicloud.sdk.projectman.v4.model.*;


public class UpdateIssueV4Solution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");

        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);

        ProjectManClient client = ProjectManClient.newBuilder()
                .withCredential(auth)
                .withRegion(ProjectManRegion.valueOf("<YOUR REGION>"))
                .build();
        UpdateIssueV4Request request = new UpdateIssueV4Request();
        request.withProjectId("{project_id}");
        request.withIssueId({issue_id});
        IssueRequestV4 body = new IssueRequestV4();
        body.withStatusId(2);
        request.withBody(body);
        try {
            UpdateIssueV4Response response = client.updateIssueV4(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}
 
 
  

Python

     # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkprojectman.v4.region.projectman_region import ProjectManRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkprojectman.v4 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]

    credentials = BasicCredentials(ak, sk)

    client = ProjectManClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(ProjectManRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = UpdateIssueV4Request()
        request.project_id = "{project_id}"
        request.issue_id = {issue_id}
        request.body = IssueRequestV4(
            status_id=2
        )
        response = client.update_issue_v4(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)
 
 
  

Go

     package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    projectman "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/projectman/v4"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/projectman/v4/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/projectman/v4/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")

    auth, err := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        SafeBuild()

    if err != nil {
        fmt.Println(err)
        return
    }

    hcClient, err := projectman.ProjectManClientBuilder().
         WithRegion(region.ValueOf("<YOUR REGION>")).
         WithCredential(auth).
         SafeBuild()


    if err != nil {
        fmt.Println(err)
        return
    }

    client := projectman.NewProjectManClient(hcClient)

    request := &model.UpdateIssueV4Request{}
	request.ProjectId = "{project_id}"
	request.IssueId = int32({issue_id})
	statusIdIssueRequestV4:= int32(2)
	request.Body = &model.IssueRequestV4{
		StatusId: &statusIdIssueRequestV4,
	}
	response, err := client.UpdateIssueV4(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}
 
 
  

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

Status Codes

Status Code	Description
200	OK
400	Bad Request
401	Unauthorized

Error Codes

See Error Codes.

Parent topic: Scrum Project Work Items

Previous topic: Querying Work Item Details

Next topic: Deleting a Work Item (V4)