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 | The 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 formatting is supported. |
project_id | string | No | ID of the project to add the issue to |
priority | number | No | Priority level, from 1 to 5 |
assignee_id | string | No | ID of the user 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 a Linear issue to a different workflow state, such as Todo or Done, using the new state's ID.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_id | string | Yes | Linear issue ID to update |
state_id | string | Yes | ID of the workflow state to move the issue to |
Response
{
"issue": {
"id": "abc123xyz789",
"identifier": "abc123xyz789",
"state": {
"id": "state123",
"name": "Active"
},
"title": "Sample Item"
}
}