# Update a issue

URL: https://docs.ones.cn/developer/openapi/api/04-update-a-issue

```
PUT
## /project/issues/:issueID

```

Update a issue.

This operation does not update the issue status. To update the status, first query the issue's executable workflows, then execute the selected workflow by using `POST /project/issues/{issueID}?action=executeWorkflow` .

## History

| Version | Changes |
| --- | --- |
| v3.14.117, v3.15.26 | Added in: v3.14.117, v3.15.26 |
| v6.18.25 | The value field is now optional in the fieldValues structure. You can either provide a null value or omit the value field entirely to clear the existing property value of the issue |
| v6.94.7 | The type field in fieldValues is optional (required in v6.94.6 and earlier). |

## Request

### Path Parameters

**issueID** stringrequired The id of the issue.

### Query Parameters

**teamID** stringrequired The team ID

- application/json

### Body

**required

** Issue information to update.

**assignee** string **Possible values:**`non-empty` and `<= 8 characters`

Issue assignee.

**title** string **Possible values:**`non-empty` and `<= 1024 characters`

Issue title.

**fieldValues

** object[]

Issue Property Information.

- Array [
**fieldID** stringrequired **Possible values:**`>= 8 characters`

ID of the issue.

**type** integer **Possible values:**`>= 1`

Type of the field value (required in v6.94.6 and earlier).

**value

** object

Value of the issue. For operation steps (field159), use an array of OperationStep objects. When either null is passed or no value is provided, the existing property value will be cleared.

**** object

- ]

## Responses

- 200
- 401
- 403
- 404
- 500

Request is successful.

- application/json

- Schema
- Example (from schema)

**Schema

**

**data

** object

**id** string ID of the issue.

**number** integer Number of the issue.

**title** string Title of the issue.

**projectID** string Project of the issue.

**issueTypeID** string Type of the issue.

**parentID** string Parent issue ID.

**result** string The result of this request.

**errorCode** string The error code of this request.

**errorMsg** string Error message for this request.

**errorData** object Error meta data for this request.

```json
[
  {
    "result": "SUCCESS",
    "data": {
      "id": "5f1b8a16",
      "number": 1,
      "title": "test",
      "projectID": "5f1b8a158765h",
      "issueTypeID": "9c6d4c01",
      "parentID": "7f1b8a18"
    }
  },
  {
    "result": "FAIL",
    "errorCode": "NotFound",
    "errorMsg": "NotFound issue"
  }
]
```

Returned if the authentication credentials are incorrect or missing.

- application/json

- Schema
- Example (from schema)

**Schema

**

**result** string The result of this request.

**errorCode** string The error code of this request.

**errorMsg** string Error message for this request.

```json
{
  "result": "FAIL",
  "errorCode": "Unauthorized",
  "errorMsg": "Access token is invalid"
}
```

Returns if the scope check fails.

- application/json

- Schema
- Example (from schema)

**Schema

**

**result** string The result of this request.

**errorCode** string The error code of this request.

**errorMsg** string Error message for this request.

```json
{
  "result": "FAIL",
  "errorCode": "Forbidden",
  "errorMsg": "Scope is invalid"
}
```

Returned if the resource object was not found.

- application/json

- Schema
- Example (from schema)

**Schema

**

**result** string The result of this request.

**errorCode** string The error code of this request.

**errorMsg** string Error message for this request.

```json
{
  "result": "FAIL",
  "errorCode": "NotFound",
  "errorMsg": "Not Found"
}
```

Internal Server Error.

- application/json

- Schema
- Example (from schema)

**Schema

**

**result** string The result of this request.

**errorCode** string The error code of this request.

**errorMsg** string Error message for this request.

```json
{
  "result": "FAIL",
  "errorCode": "Internal Server Error",
  "errorMsg": "Internal Server Error"
}
```