---
name: tracker/linear-cli:issue-update
description: Update fields on an existing Linear issue using the linear CLI
version: "0.4.0"
---

# Issue Update

Modify one or more fields on an existing Linear issue identified by its identifier or UUID.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| id | string | Yes | Issue identifier (e.g., `ENG-123`) or internal UUID |
| title | string | No | New issue title |
| description | string | No | New issue body (markdown supported) |
| priority | string | No | New priority: `urgent`, `high`, `medium`, `low`, `none` |
| label | string | No | Label name to apply; repeat flag for multiple |
| assignee | string | No | New assignee username or email |

## Implementation

```bash
linear issue update {id} \
  {title ? `--title "{title}"` : ""} \
  {description ? `--description "{description}"` : ""} \
  {priority ? `--priority {priority}` : ""} \
  {label ? `--label "{label}"` : ""} \
  {assignee ? `--assignee "{assignee}"` : ""}
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| identifier | string | Human-readable issue ID (e.g., `ENG-123`) |
| url | string | Direct URL to the updated issue |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| AUTH_FAILED | API key is missing or invalid | Run `linear auth` to authenticate |
| NOT_FOUND | No issue matches the provided identifier | Verify the ID with `linear issue list` |
| VALIDATION_ERROR | At least one update field must be provided, or a field value is invalid | Provide at least one optional flag with a valid value |

## Used By

- dev-task (update issue state, description, or assignee during implementation)
