Linear

Learn how to use Linear with Composio

Overview

SLUG

LINEAR

Description

Linear is a streamlined issue tracking and project planning tool for modern teams, featuring fast workflows, keyboard shortcuts, and GitHub integrations

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to admin,read,write,issues:create,comments:create
full
stringDefaults to https://api.linear.app
bearer_token
string
generic_api_key
stringRequired
full
stringDefaults to https://api.linear.app

Tools

SLUG: LINEAR_REMOVE_ISSUE_LABEL

Removes a specified label from an existing linear issue using their ids; successful even if the label isn't on the issue.

Action Parameters

issue_id
stringRequired
label_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_UPDATE_ISSUE

Updates an existing linear issue using its `issue id`; requires at least one other attribute for modification, and all provided entity ids (for state, assignee, labels, etc.) must be valid.

Action Parameters

assignee_id
string
description
string
due_date
string
estimate
integer
issue_id
stringRequired
label_ids
array
parent_id
string
priority
integer
project_id
string
state_id
string
team_id
string
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_CREATE_LINEAR_ATTACHMENT

Creates a new attachment and associates it with a specific, existing linear issue.

Action Parameters

issue_id
stringRequired
subtitle
stringRequired
title
stringRequired
url
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_CREATE_LINEAR_COMMENT

Creates a new comment on a specified linear issue.

Action Parameters

body
stringRequired
issue_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_CREATE_LINEAR_ISSUE

Creates a new issue in a specified linear project and team, requiring a title and description, and allowing for optional properties like assignee, state, priority, and due date.

Action Parameters

assignee_id
string
description
stringRequired
due_date
string
estimate
integer
label_ids
array
parent_id
string
priority
integer
project_id
stringRequired
state_id
string
team_id
stringRequired
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_CREATE_LINEAR_ISSUE_DETAILS

Fetches a linear team's default issue estimate and state, useful for pre-filling new issue forms.

Action Parameters

team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_CREATE_LINEAR_LABEL

Creates a new label in linear for a specified team, used to categorize and organize issues.

Action Parameters

color
stringRequired
description
string
name
stringRequired
team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_DELETE_LINEAR_ISSUE

Archives an existing linear issue by its id, which is linear's standard way of deleting issues; the operation is idempotent.

Action Parameters

issue_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_GET_ATTACHMENTS

Downloads a specific attachment from a linear issue; the `file name` must include the correct file extension.

Action Parameters

attachment_id
stringRequired
file_name
stringRequired
issue_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_GET_CYCLES_BY_TEAM_ID

Retrieves all cycles for a specified linear team id; cycles are time-boxed work periods (like sprints) and the team id must correspond to an existing team.

Action Parameters

team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_GET_LINEAR_ISSUE

Retrieves an existing linear issue's comprehensive details, including title, description, attachments, and comments.

Action Parameters

issue_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_LIST_LINEAR_CYCLES

Retrieves all cycles (time-boxed iterations for work) from the linear account; no filters are applied.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_LIST_LINEAR_ISSUES

Lists non-archived linear issues; if project id is not specified, issues from all accessible projects are returned.

Action Parameters

after
string
first
integerDefaults to 10
project_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_LIST_LINEAR_LABELS

Retrieves all labels associated with a given team id in linear; the team id must refer to an existing team.

Action Parameters

team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_LIST_LINEAR_PROJECTS

Retrieves all projects from the linear account.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_LIST_LINEAR_STATES

Retrieves all workflow states for a specified team in linear, representing the stages an issue progresses through in that team's workflow.

Action Parameters

team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_LIST_LINEAR_TEAMS

Retrieves all teams, including their members, and filters each team's associated projects by the provided 'project id'.

Action Parameters

project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: LINEAR_RUN_QUERY_OR_MUTATION

Executes a user-provided graphql query or mutation against the linear api, intended for advanced data operations or those not covered by other specific actions.

Action Parameters

query_or_mutation
stringRequired
variables
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired