Linear

Learn how to use Linear with Composio

Overview

Enum

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

Actions

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

Action Parameters

body
stringRequired
issue_id
stringRequired

Action Response

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

Action Parameters

Action Response

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