Linear

Linear is a project management and issue tracking tool designed primarily for software teams.

Categories: Project Management

Type: linear/v1

Connections

Version: 1

OAuth2 Authorization Code

Properties

Name	Label	Type	Description	Required
clientId	Client Id	STRING		true
clientSecret	Client Secret	STRING		true

Actions

Create Issue

Name: createIssue

Creates a new issue.

Properties

Name	Label	Type	Description	Required
title	Issue Title	STRING	`The title of the new issue.`	true
teamId	Team ID	STRING	`The ID of the team where this issue should be created.`	true
statusId	Status	STRING	`The status of the issue.`	true
priority	Priority	INTEGER Options 0, 1, 2, 3, 4	`The priority of the issue.`	false
assigneeId	Assignee ID	STRING	`The identifier of the user to assign the issue to.`	false
description	Description	STRING	`The detailed description of the issue.`	false

Example JSON Structure

{
  "label" : "Create Issue",
  "name" : "createIssue",
  "parameters" : {
    "title" : "",
    "teamId" : "",
    "statusId" : "",
    "priority" : 1,
    "assigneeId" : "",
    "description" : ""
  },
  "type" : "linear/v1/createIssue"
}

Output

Type: OBJECT

Properties

Name	Type	Description
success	BOOLEAN Options true, false	Whether the operation was successful.
issue	OBJECT Properties {STRING(id), STRING(title)}	The issue that was created or updated.

Output Example

{
  "success" : false,
  "issue" : {
    "id" : "",
    "title" : ""
  }
}

Update Issue

Name: updateIssue

Update an issue.

Properties

Name	Label	Type	Description	Required
teamId	Team ID	STRING	`The ID of the team where this issue should be created.`	true
issueId	Issue ID	STRING Depends On teamId	`The identifier of the issue to update.`	true
title	Issue Title	STRING	`The title of the new issue.`	false
statusId	Status	STRING	`The status of the issue.`	false
priority	Priority	INTEGER Options 0, 1, 2, 3, 4	`The priority of the issue.`	false
assigneeId	Assignee ID	STRING	`The identifier of the user to assign the issue to.`	false
description	Description	STRING	`The detailed description of the issue.`	false

Example JSON Structure

{
  "label" : "Update Issue",
  "name" : "updateIssue",
  "parameters" : {
    "teamId" : "",
    "issueId" : "",
    "title" : "",
    "statusId" : "",
    "priority" : 1,
    "assigneeId" : "",
    "description" : ""
  },
  "type" : "linear/v1/updateIssue"
}

Output

Type: OBJECT

Properties

Name	Type	Description
success	BOOLEAN Options true, false	Whether the operation was successful.
issue	OBJECT Properties {STRING(id), STRING(title)}	The issue that was created or updated.

Output Example

{
  "success" : false,
  "issue" : {
    "id" : "",
    "title" : ""
  }
}

Create Project

Name: createProject

Creates a new project.

Properties

Name	Label	Type	Description	Required
name	Project Name	STRING	`The name of the project.`	true
teamId	Team ID	STRING	`The ID of the team where this project should be created.`	true
statusId	Status	STRING	`The status of the project.`	false
priority	Priority	INTEGER Options 0, 1, 2, 3, 4	`The priority of the project.`	false
startDate	Start Date	DATE	`The planned start date of the project.`	false
description	Description	STRING	`The detailed description of the project.`	false

Example JSON Structure

{
  "label" : "Create Project",
  "name" : "createProject",
  "parameters" : {
    "name" : "",
    "teamId" : "",
    "statusId" : "",
    "priority" : 1,
    "startDate" : "2021-01-01",
    "description" : ""
  },
  "type" : "linear/v1/createProject"
}

Output

Type: OBJECT

Properties

Name	Type	Description
success	BOOLEAN Options true, false	Whether the operation was successful.
project	OBJECT Properties {STRING(id), STRING(name)}	The project that was created or updated.

Output Example

{
  "success" : false,
  "project" : {
    "id" : "",
    "name" : ""
  }
}

Update Project

Name: updateProject

Update a project.

Properties

Name	Label	Type	Description	Required
projectId	Project ID	STRING	`The identifier of the project to update.`	true
name	Project Name	STRING	`The name of the project.`	false
statusId	Status	STRING	`The status of the project.`	false
priority	Priority	INTEGER Options 0, 1, 2, 3, 4	`The priority of the project.`	false
startDate	Start Date	DATE	`The planned start date of the project.`	false
description	Description	STRING	`The detailed description of the issue.`	false

Example JSON Structure

{
  "label" : "Update Project",
  "name" : "updateProject",
  "parameters" : {
    "projectId" : "",
    "name" : "",
    "statusId" : "",
    "priority" : 1,
    "startDate" : "2021-01-01",
    "description" : ""
  },
  "type" : "linear/v1/updateProject"
}

Output

Type: OBJECT

Properties

Name	Type	Description
success	BOOLEAN Options true, false	Whether the operation was successful.
project	OBJECT Properties {STRING(id), STRING(name)}	The project that was created or updated.

Output Example

{
  "success" : false,
  "project" : {
    "id" : "",
    "name" : ""
  }
}

Create Comment

Name: createComment

Creates a new comment.

Properties

Name	Label	Type	Description	Required
teamId	Team ID	STRING	`The ID of the team where this issue should be created.`	true
issueId	Issue ID	STRING Depends On teamId	`The identifier of the issue to update.`	true
body	Comment Body	STRING	`The comment content in markdown format.`	true

Example JSON Structure

{
  "label" : "Create Comment",
  "name" : "createComment",
  "parameters" : {
    "teamId" : "",
    "issueId" : "",
    "body" : ""
  },
  "type" : "linear/v1/createComment"
}

Output

Type: OBJECT

Properties

Name	Type	Description
success	BOOLEAN Options true, false	Whether the operation was successful.
comment	OBJECT Properties {STRING(id), {STRING(id)}(issue), STRING(body)}	The comment that was created.

Output Example

{
  "success" : false,
  "comment" : {
    "id" : "",
    "issue" : {
      "id" : ""
    },
    "body" : ""
  }
}

Raw Graphql Query

Name: rawGraphqlQuery

Perform a raw Graphql query.

Properties

Name	Label	Type	Description	Required
query	Query	STRING	`The query to perform.`	true
variables	Variables	STRING	`The variables for the query.`	false

Example JSON Structure

{
  "label" : "Raw Graphql Query",
  "name" : "rawGraphqlQuery",
  "parameters" : {
    "query" : "",
    "variables" : ""
  },
  "type" : "linear/v1/rawGraphqlQuery"
}

Output

Type: OBJECT

Properties

Name	Type	Description
data	OBJECT Properties {}	Response data.

Output Example

{
  "data" : { }
}

Triggers

New Issue

Name: newIssue

Triggers when new issue is created.

Type: DYNAMIC_WEBHOOK

Properties

Name	Label	Type	Description	Required
allPublicTeams	All Public Teams	BOOLEAN Options true, false	`If true, the webhook will be created for all public teams.`	true
teamId	Team ID	STRING		true

Output

Type: OBJECT

Properties

Name	Type	Description
id	STRING	The unique identifier of the entity.
title	STRING	The issue's title.
team	OBJECT Properties {STRING(id), STRING(name)}	The team that the issue is associated with.
state	OBJECT Properties {STRING(name)}	The workflow state that the issue is associated with.
priority	STRING	The priority of the issue.
assignee	OBJECT Properties {STRING(id), STRING(name)}	The user to whom the issue is assigned to.
description	STRING	The issue's description in markdown format.

JSON Example

{
  "label" : "New Issue",
  "name" : "newIssue",
  "parameters" : {
    "allPublicTeams" : false,
    "teamId" : ""
  },
  "type" : "linear/v1/newIssue"
}

Updated Issue

Name: updatedIssue

Triggers when an issue is updated.

Type: DYNAMIC_WEBHOOK

Properties

Name	Label	Type	Description	Required
allPublicTeams	All Public Teams	BOOLEAN Options true, false	`If true, the webhook will be created for all public teams.`	true
teamId	Team ID	STRING		true

Output

Type: OBJECT

Properties

Name	Type	Description
id	STRING	The unique identifier of the entity.
title	STRING	The issue's title.
team	OBJECT Properties {STRING(id), STRING(name)}	The team that the issue is associated with.
state	OBJECT Properties {STRING(name)}	The workflow state that the issue is associated with.
priority	STRING	The priority of the issue.
assignee	OBJECT Properties {STRING(id), STRING(name)}	The user to whom the issue is assigned to.
description	STRING	The issue's description in markdown format.

JSON Example

{
  "label" : "Updated Issue",
  "name" : "updatedIssue",
  "parameters" : {
    "allPublicTeams" : false,
    "teamId" : ""
  },
  "type" : "linear/v1/updatedIssue"
}

Removed Issue

Name: removedIssue

Triggers when an issue is removed.

Type: DYNAMIC_WEBHOOK

Properties

Name	Label	Type	Description	Required
allPublicTeams	All Public Teams	BOOLEAN Options true, false	`If true, the webhook will be created for all public teams.`	true
teamId	Team ID	STRING		true

Output

Type: OBJECT

Properties

Name	Type	Description
id	STRING	The unique identifier of the entity.
title	STRING	The issue's title.
team	OBJECT Properties {STRING(id), STRING(name)}	The team that the issue is associated with.
state	OBJECT Properties {STRING(name)}	The workflow state that the issue is associated with.
priority	STRING	The priority of the issue.
assignee	OBJECT Properties {STRING(id), STRING(name)}	The user to whom the issue is assigned to.
description	STRING	The issue's description in markdown format.

JSON Example

{
  "label" : "Removed Issue",
  "name" : "removedIssue",
  "parameters" : {
    "allPublicTeams" : false,
    "teamId" : ""
  },
  "type" : "linear/v1/removedIssue"
}

On this page