# devops work-item create

Create a new work item in a DevOps Center project.

## Description for devops work-item create

The command creates the work item using the Connect API. Requires a project ID and a subject for the new work item; run the `devops project list` command to get the IDs for all existing projects.

## 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`  | `-d`              | **Type:** Value<br><br>Description of the new work item; if not specified, the description is blank.                                                |
| `--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.                                                                                                     |
| `--project-id`   | `-p`              | **Type:** Value<br>**Required**<br><br>ID of the DevOps Center project to create the work item in.                                                  |
| `--subject`      | `-s`              | **Type:** Value<br>**Required**<br><br>Subject (title) of the new 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. |

## Examples for devops work-item create

Create a work item for the project with the specified ID and give the work item the specified subject (title); use the DevOps Center org with alias "my-devops-org":

```shell
sf devops work-item create --target-org my-devops-org --project-id 1Qg000000000001 --subject "Fix login bug"
```

Create a work item with a subject and description:

```shell
sf devops work-item create --target-org my-devops-org --project-id 1Qg000000000001 --subject "Add dark mode" --description "Implement dark mode toggle in settings page"
```