lin issue

Create, inspect and manage issues

lin issue add-label

add-label one label on an issue without touching the rest of the set

lin issue add-label <id>

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--label`	string	-	label name or UUID

lin issue add-to-release

Link an issue to a release

lin issue add-to-release <id>

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--release`	string	-	release UUID

lin issue archive

Archive an issue

lin issue archive <id>

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing

lin issue batch-create

Create several issues in one call (raw --json only)

lin issue batch-create

Example

lin issue batch-create --json '{"issues":[{"teamId":"...","title":"A"},{"teamId":"...","title":"B"}]}'

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--json`	string	-	raw GraphQL input payload as JSON ('-' reads stdin); exclusive with per-field flags

lin issue batch-update

Apply one update to several issues (UUIDs + raw --json)

lin issue batch-update

Example

lin issue batch-update --ids uuid1,uuid2 --json '{"stateId":"..."}'

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--ids`	stringSlice	[]	issue UUIDs (comma list)
`--json`	string	-	raw GraphQL input payload as JSON ('-' reads stdin); exclusive with per-field flags

lin issue create

Create an issue

lin issue create

Examples

lin issue create --team ENG --title "Fix login" --labels bug --assignee me
lin issue create --json '{"teamId":"...","title":"Fix login"}'

Flag	Type	Default	Description
`--assignee`	string	-	assignee: email, UUID or "me"
`--body-file`	string	-	read the text from a file ('-' reads stdin)
`--cycle`	string	-	cycle: number (requires --team) or UUID
`--description`	string	-	issue description (markdown)
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--due-date`	string	-	due date (YYYY-MM-DD)
`--estimate`	int	0	issue estimate points
`--json`	string	-	raw GraphQL input payload as JSON ('-' reads stdin); exclusive with per-field flags
`--labels`	stringSlice	[]	labels (names or UUIDs, comma list)
`--milestone`	string	-	project milestone: name (requires --project) or UUID
`--parent`	string	-	parent issue: identifier or UUID
`--priority`	string	-	priority: none, urgent, high, medium, low or 0-4
`--project`	string	-	project: name or UUID
`--state`	string	-	workflow state: name or UUID
`--team`, `-t`	string	-	team key or UUID
`--title`	string	-	issue title

lin issue delete

Move an issue to trash (requires --confirm=<id>)

lin issue delete <id>

Flag	Type	Default	Description
`--confirm`	string	-	confirm the destructive action by repeating the resource id
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing

lin issue get

Show one issue (identifier like ENG-123 or UUID)

lin issue get <id>

Example

lin issue get ENG-123 --fields identifier,title,state

lin issue list

List issues with filters

lin issue list

Examples

lin issue list --team ENG --state "In Progress" --fields identifier,title
lin issue list --assignee me --output ndjson --all

Flag	Type	Default	Description
`--all`, `-a`	bool	false	follow cursors until exhaustion
`--assignee`	string	-	filter by assignee: email, UUID or "me"
`--creator`	string	-	filter by creator: email, UUID or "me"
`--cursor`	string	-	resume from a previous next_cursor
`--cycle`	string	-	filter by cycle UUID
`--include-archived`	bool	false	include archived issues
`--label`	stringSlice	[]	filter by label name(s), all must match
`--limit`, `-l`	int	50	page size
`--parent`	string	-	filter by parent issue identifier or UUID
`--priority`	string	-	filter by priority: none, urgent, high, medium, low or 0-4
`--project`	string	-	filter by project name or UUID
`--query`	string	-	full-text filter on title and description
`--state`	string	-	filter by state name or UUID
`--team`, `-t`	string	-	filter by team key or UUID

lin issue relate

Create a relation between two issues

lin issue relate <id> <other-id>

Example

lin issue relate ENG-1 ENG-2 --type blocks

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--type`	string	related	relation type: blocks, related, duplicate or similar

lin issue remind

Set a reminder on an issue

lin issue remind <id>

Flag	Type	Default	Description
`--at`	string	-	reminder timestamp (RFC3339)
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing

lin issue remove-from-release

Unlink an issue from a release

lin issue remove-from-release <id>

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--release`	string	-	release UUID

lin issue remove-label

remove-label one label on an issue without touching the rest of the set

lin issue remove-label <id>

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--label`	string	-	label name or UUID

subscribe the viewer (or --user) to notifications on an issue

lin issue subscribe <id>

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--user`	string	-	user email, UUID or "me" (default: the viewer)

lin issue unarchive

Unarchive an issue

lin issue unarchive <id>

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing

lin issue unrelate

Delete the relation between two issues

lin issue unrelate <id> <other-id>

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing

lin issue unsubscribe

unsubscribe the viewer (or --user) to notifications on an issue

lin issue unsubscribe <id>

Flag	Type	Default	Description
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--user`	string	-	user email, UUID or "me" (default: the viewer)

lin issue update

Update an issue. --labels REPLACES the whole label set; use --add-labels and --remove-labels for incremental changes.

lin issue update <id>

Examples

lin issue update ENG-123 --state Done
lin issue update ENG-123 --add-labels regression --priority high

Flag	Type	Default	Description
`--add-labels`	stringSlice	[]	labels to add (names or UUIDs)
`--assignee`	string	-	assignee: email, UUID or "me"
`--body-file`	string	-	read the text from a file ('-' reads stdin)
`--cycle`	string	-	cycle: number (requires --team) or UUID
`--description`	string	-	issue description (markdown)
`--dry-run`, `-n`	bool	false	print the intended operation and variables without executing
`--due-date`	string	-	due date (YYYY-MM-DD)
`--estimate`	int	0	issue estimate points
`--json`	string	-	raw GraphQL input payload as JSON ('-' reads stdin); exclusive with per-field flags
`--labels`	stringSlice	[]	labels (names or UUIDs, comma list)
`--milestone`	string	-	project milestone: name (requires --project) or UUID
`--parent`	string	-	parent issue: identifier or UUID
`--priority`	string	-	priority: none, urgent, high, medium, low or 0-4
`--project`	string	-	project: name or UUID
`--remove-labels`	stringSlice	[]	labels to remove (names or UUIDs)
`--state`	string	-	workflow state: name or UUID
`--team`, `-t`	string	-	team key or UUID
`--title`	string	-	issue title

lin issue

On this page