Modify Issue¶

POST /api/v1/issue/{issue_uuid}/modify

Overview¶

Route Parameters¶

Parameter Name	Type	Required	Description
issue_uuid	string	Y	issueUUID

Body Request Parameters¶

Parameter Name	Type	Required	Description
name	string		Title name Example: name Can be empty: False $maxCustomLength: 256
level	string		Level, corresponding to level configuration uuid Example: level Can be empty: False Can be an empty string: True
description	string		Description Example: description Can be empty: False
statusType	integer		Status of the issue Example: statusType Can be empty: False Possible values: [10, 15, 20, 25, 30]
extend	json	Y	Additional extension information, default is {} if no content Example: {} Can be empty: True
attachmentUuids	array		List of attachment upload uuids Example: [] Can be empty: True

Additional Parameter Explanations¶

Basic Parameter Explanation

Parameter Name	Parameter Type	Mandatory	Parameter Description
name	string	N	Issue title name
level	string	N	Issue level corresponding to configuration level uuid
statusType	integer	N	Issue status, 10: Open, 15: Working, 20: Resolved, 25: Closed, 30: Pending
decription	string	N	Issue description information
attachmentUuids	array	N	List of attachment upload uuids, must first be uploaded through the /api/v1/attachment/upload interface
extend	json	N	Extension fields, default send {}

Level Field Explanation Level is divided into system levels/custom levels (can be configured in Configuration Management)

Level	Value	Parameter Description
P0	system_level_0	Send parameter level: system_level_0, represents system level P0
P1	system_level_1	Send parameter level: system_level_1, represents system level P1
P2	system_level_2	Send parameter level: system_level_2, represents system level P2
P3	system_level_3	Send parameter level: system_level_3, represents system level P3
xxx	issl_yyyyy	Send parameter level: issl_yyyyy, represents custom level xxx

Extension Field Extend Explanation

Parameter Name	Parameter Type	Mandatory	Parameter Description
channels	array	N	Description content with # : Expected list of resources for issue delivery,
linkList	array	N	Add issue links
members	array	N	Description content with @ expected notification target members for issue notification
manager	array	N	User account uuid, email, team uuid
extra	json	N	Updater/responsible person's email corresponding name information for issue, used for front-end reflection

Extend field example:

{
  "members": [
    {
      "type": "@",
      "uuid": "acnt_xxxx32",
      "exists": true
    }
  ],
  "channels": [
    {
      "type": "#",
      "uuid": "chan_xxxx32",
      "exists": true
    }
  ],
  "manager": [
    "acnt_xxxxx",
    "[email protected]",
    "group_xxx",
    "[email protected]"
  ],
  "linkList": [
    {
      "name": "Resolve",
      "link": "https://sd.com"
    }
  ],
  "extra": {
    "updator": {
      "name": "xxx",
      "email": "[email protected]"
    },
    "managerInfos": {
      "[email protected]": { "name": "111" },
      "[email protected]": { "name": "222" }
    }
  }
}

Request Example¶

curl 'https://us1-openapi.truewatch.com/api/v1/issue/issue_xxxx32/modify' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"statusType":20}'\
--compressed

Response¶

{
    "code": 200,
    "content": {
        "createAt": 1686398344,
        "creator": "acnt_xxxx32",
        "creatorInfo": {
            "acntWsNickname": "",
            "email": "[email protected]",
            "iconUrl": "",
            "name": "wanglei-testing",
            "username": "[email protected]"
        },
        "deleteAt": -1,
        "description": "",
        "extend": {
            "channels": [
                {
                    "exists": true,
                    "type": "#",
                    "uuid": "chan_xxxx32"
                }
            ],
            "view_isuue_url": ""
        },
        "id": 47402,
        "level": "system_level_2",
        "name": "dcacscsc",
        "resource": "",
        "resourceType": "",
        "resourceUUID": "",
        "status": 0,
        "statusType": 20,
        "subIdentify": "",
        "updateAt": 1686400483,
        "updator": "acnt_xxxx32",
        "updatorInfo": {
            "acntWsNickname": "",
            "email": "[email protected]",
            "iconUrl": "",
            "name": "wanglei-testing",
            "username": "[email protected]"
        },
        "uuid": "issue_xxxx32",
        "workspaceUUID": "wksp_xxxx32"
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "1744405827768254151"
}