Linear
API actions for the Linear integration.
Linear
Create and manage Linear issues with a personal API key.
Add a comment to a Linear issue
Post a comment on a Linear issue thread.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_id | string | Yes | Linear issue ID to comment on |
body | string | Yes | comment text to post |
Response
{
"comment": {
"body": "Sample text content",
"id": "abc123xyz789"
}
}Create a Linear issue
Create a new Linear issue with optional project, description, priority, and assignee.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | Linear team ID for the issue |
title | string | Yes | Issue title |
description | string | No | issue description (markdown supported) |
project_id | string | No | project ID to associate with the issue |
priority | number | No | priority integer (1-5) |
assignee_id | string | No | user ID to assign the issue to |
Response
{
"issue": {
"id": "abc123xyz789",
"identifier": "abc123xyz789",
"state": {
"id": "state123",
"name": "Todo"
},
"title": "Sample Item",
"url": "https://example.com/path/123"
}
}Get Linear issue details
Retrieve detailed information for a Linear issue.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_id | string | Yes | Linear issue ID to fetch |
Response
{
"issue": {
"description": "example_value",
"id": "abc123xyz789",
"identifier": "abc123xyz789",
"state": {
"id": "state123",
"name": "Active"
},
"title": "Sample Item",
"url": "https://example.com/path/123"
}
}List Linear issues for a team
Fetch the latest Linear issues for a specific team.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | Linear team ID to list issues for |
first | number | No | Maximum number of issues to return (1-50) |
Response
{
"issues": [
{
"id": "item123",
"name": "Sample Task"
}
]
}List Linear teams
Fetch available Linear teams for the connected workspace.
Response
{
"teams": [
{
"id": "team123",
"key": "ENG",
"name": "Engineering"
}
]
}Update Linear issue state
Move an issue to a new state using the target state ID.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_id | string | Yes | Linear issue ID to update |
state_id | string | Yes | Target Linear workflow state ID |
Response
{
"issue": {
"id": "abc123xyz789",
"identifier": "abc123xyz789",
"state": {
"id": "state123",
"name": "Active"
},
"title": "Sample Item"
}
}