# devops work-item update

Update a work item in DevOps Center.

## Description for devops work-item update

Update the subject, description, or status of a work item. At least one of --subject, --description, or --status must be provided.

## Flags

| Flag Name (Long)   | Flag Name (Short) | Description                                                                                                                                                    |
| ------------------ | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--api-version`    | N/A               | **Type:** Value<br><br>Override the api version used for api requests made by this command                                                                     |
| `--description`    | N/A               | **Type:** Value<br><br>New description for the work item.                                                                                                      |
| `--flags-dir`      | N/A               | **Type:** Value<br><br>Import flag values from a directory.                                                                                                    |
| `--json`           | N/A               | **Type:** Boolean<br><br>Format output as json.                                                                                                                |
| `--status`         | N/A               | **Type:** Value<br>**Valid Values:** `In Progress`, `Ready to Promote`<br><br>New status for the work item. Allowed values: "In Progress", "Ready to Promote". |
| `--subject`        | N/A               | **Type:** Value<br><br>New subject for the work item.                                                                                                          |
| `--target-org`     | `-o`              | **Type:** Value<br>**Required**<br><br>Username or alias of the target org. Not required if the `target-org` configuration variable is already set.            |
| `--work-item-id`   | `-w`              | **Type:** Value<br><br>ID of the work item.                                                                                                                    |
| `--work-item-name` | `-n`              | **Type:** Value<br><br>Name of the work item, such as WI-000001.                                                                                               |

## Examples for devops work-item update

Update the subject of a work item by name:

```shell
sf devops work-item update --target-org my-devops-org --work-item-name WI-000001 --subject "Fix login bug"
```

Update the status of a work item by ID:

```shell
sf devops work-item update --target-org my-devops-org --work-item-id 0Wx000000000001 --status "In Progress"
```

Update multiple fields at once:

```shell
sf devops work-item update --target-org my-devops-org --work-item-name WI-000001 --subject "Fix login bug" --description "Users can't log in on mobile" --status "In Progress"
```