# devops work-item prepare

Prepare a work item for one-off promotion between pipeline stages.

## Description for devops work-item prepare

Prepares a work item for one-off promotion by creating the necessary branches and pull requests in the source control repository. Run this command before running "sf devops work-item promote" for a one-off promotion.

Use "sf devops work-item list" to find the work item ID and target stage ID for a project.

## 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                                                          |
| `--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.                                                                                                     |
| `--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. |
| `--target-stage-id` | `-t`              | **Type:** Value<br>**Required**<br><br>ID of the pipeline stage to promote the work item to.                                                        |
| `--work-item-id`    | `-i`              | **Type:** Value<br>**Required**<br><br>ID of the work item to prepare for one-off promotion.                                                        |

## Examples for devops work-item prepare

Prepare a work item for one-off promotion to the UAT stage:

```shell
sf devops work-item prepare --target-org my-devops-org --work-item-id 0Wx000000000001 --target-stage-id 05S000000000002
```

Prepare a work item using a DevOps Center org username:

```shell
sf devops work-item prepare --target-org devops-center@example.com --work-item-id 0Wx000000000001 --target-stage-id 05S000000000002
```