Linear

Learn how to use Linear with Composio

Overview

Enum

LINEAR

Description

Connect to Linear to create and manage issues, list projects, teams, and more

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
base_url
stringDefaults to https://api.linear.app
api_key
stringRequired
base_url
stringDefaults to https://api.linear.app

Actions

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
object
error
successful
boolean
Creates a new comment on a specified linear issue.

Action Parameters

body
stringRequired
issue_id
stringRequired

Action Response

data
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
Retrieves an existing linear issue's comprehensive details, including title, description, attachments, and comments.

Action Parameters

issue_id
stringRequired

Action Response

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

Action Parameters

Action Response

data
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
Retrieves all projects from the linear account.

Action Parameters

Action Response

data
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean