NAME

gh-project-item-edit - Edit an item in a project

SYNOPSIS

gh project item-edit [<number>] [flags]

DESCRIPTION

Edit a draft issue or a project item.

The usual way to select the item and field is by name: pass the project number plus --owner, point at the item with its issue or pull request --url, and name the field with --field. For single-select fields, --value is the option name.

For scripts and machine use, you can also pass GraphQL node IDs directly with --id, --field-id and --project-id (and, for single-select fields, --single-select-option-id).

Note that --url is the issue or pull request URL, not a project URL, so its owner may differ from the project's; --owner selects the project.

For non-draft issues, only a single field value can be updated per invocation.

Remove a project item field value with --clear.

OPTIONS

--body <string>: Body of the draft issue item
--clear: Remove field value
--date <string>: Date value for the field (YYYY-MM-DD)
--field <string>: Name of the field to update
--field-id <string>: ID of the field to update
--format <string>: Output format: {json}
--id <string>: ID of the item to edit
--iteration-id <string>: ID of the iteration value to set on the field
-q, --jq <expression>: Filter JSON output using a jq expression
--number <float> (default 0): Number value for the field
--owner <string>: Login of the owner. Use "@me" for the current user.
--project-id <string>: ID of the project to which the field belongs to
--single-select-option-id <string>: ID of the single select option value to set on the field
-t, --template <string>: Format JSON output using a Go template; see "gh help formatting"
--text <string>: Text value for the field
--title <string>: Title of the draft issue item
--url <string>: URL of the issue or pull request whose project item to edit
--value <--field>: Value to set on the field named by --field

EXIT CODES

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

EXAMPLE

# Set the "Status" field to "In Progress" for an issue on monalisa's project 1
$ gh project item-edit 1 --owner monalisa --url https://github.com/monalisa/myproject/issues/23 --field "Status" --value "In Progress"
# Edit an item's text field value by node ID (machine / scripted use)
$ gh project item-edit --id <item-id> --field-id <field-id> --project-id <project-id> --text "new text"
# Clear an item's field value by node ID
$ gh project item-edit --id <item-id> --field-id <field-id> --project-id <project-id> --clear