Skip to main content
Linear logo
  • Category: project management
  • Auth: OAUTH2, API_KEY
  • Composio-managed OAuth available? Yes
  • Tools: 48
  • Triggers: 12
  • Slug: LINEAR
  • Version: 20261101_00

Tools

Slug: LINEAR_ARCHIVE_ISSUEArchives an existing Linear issue by its UUID or shorthand identifier, removing it from active views while preserving its data for future reference.

Input Parameters

string
required
ID of the Linear issue to be archived. Must be in one of two formats: (1) UUID format: a 36-character string with hyphens (e.g., ‘c5748ccf-c67f-4af4-bd74-fe513dc4c054’), or (2) Shorthand identifier: team key (alphanumeric, must start with a letter, 1-10 chars) followed by hyphen and issue number (e.g., ‘ENG-123’, ‘MAN8-456’). Note: Plain numeric IDs are NOT valid Linear issue identifiers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_ARCHIVE_PROJECTArchives an existing Linear project by its UUID, removing it from active views. Use this action when you need to mark a completed or obsolete project as archived. Archiving is reversible (projects can be unarchived later), but confirm the project name with the user before executing, especially in bulk operations.

Input Parameters

string
required
UUID of the Linear project to be archived. Must be a 36-character UUID string with hyphens (e.g., ‘a1b2c3d4-e5f6-7890-1234-567890abcdef’). Use LINEAR_LIST_LINEAR_PROJECTS or LINEAR_GET_LINEAR_PROJECT to retrieve valid project UUIDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_ARCHIVE_PROJECT_UPDATEArchives a project update in Linear, hiding it from the default view while preserving its data. Use this action when you need to clean up old or obsolete project status updates without permanently deleting them. Archived updates can be unarchived later if needed. This action is irreversible only in the sense that the project update will be hidden from active views until explicitly unarchived.

Input Parameters

string
required
The unique identifier (UUID) of the project update to archive. Must be a valid Linear project update UUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Once archived, the project update will be hidden from the default view but can still be accessed or unarchived later.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_CREATE_ATTACHMENTCreates a new attachment and associates it with a specific, existing Linear issue.

Input Parameters

string
required
URL of the attachment’s content (e.g., file, webpage, online resource).
string
required
Title for the attachment.
string
required
Identifier of the existing Linear issue to which the attachment will be added. Accepts either UUID format (e.g., ‘590a1127-f98b-49fc-ba74-2df8751c089e’) or issue key format (e.g., ‘GHO-300’, ‘ENG-123’).
string
Optional subtitle or short description for the attachment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_CREATE_COMMENT_REACTIONTool to add a reaction to an existing Linear comment. Use when you want to programmatically react to a comment on an issue.

Input Parameters

string
required
Emoji for the reaction. Supports Unicode emojis or shortcodes like ‘:thumbsup:’.
string
required
Identifier of the existing Linear comment to add the reaction to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_CREATE_LINEAR_COMMENTCreates a new comment on a specified Linear issue. This action modifies shared workspace data and is not reversible — confirm the target issue and comment content before executing.

Input Parameters

string
required
Non-empty comment content, in plain text or Markdown. Must not be whitespace-only.
string
required
ID of the Linear issue to add the comment to. Must be in one of two formats: (1) UUID format: a 36-character string with hyphens (e.g., ‘c5748ccf-c67f-4af4-bd74-fe513dc4c054’), or (2) Shorthand identifier: team key (alphanumeric, must start with a letter, 1-10 chars) followed by hyphen and issue number (e.g., ‘ENG-123’, ‘PROJ-456’). Use LIST_LINEAR_ISSUES action to retrieve valid issue IDs if needed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_CREATE_LINEAR_ISSUECreates an issue in a specified Linear team with a title and optional project, description, assignee, state, priority, cycle, due date, and other properties. Returns the created issue’s ID and URL.

Input Parameters

string
required
The title of the new issue.
string
required
UUID of the team responsible for this issue. IMPORTANT: You must use a valid team UUID that exists in your Linear workspace and that the authenticated user has access to. Use the LINEAR_GET_ALL_LINEAR_TEAMS action to retrieve the list of available teams and their UUIDs. Do not use team keys (like ‘INT’ or ‘ENG’) or team names (like ‘Backend’ or ‘Frontend’) - only the UUID format is accepted (e.g., ‘9a7f1e3c-4d5b-6a7f-8e9d-0a1b2c3d4e5f’).
string
UUID of the cycle (sprint) to assign this issue to. Cycles are time-bound periods used to organize and prioritize work. Only applicable if the team has cycles feature enabled. Must be a valid UUID format. Must belong to the same team as team_id.
string
The target completion date for the issue in ISO8601 datetime format or YYYY-MM-DD TimelessDate format (e.g., ‘2024-12-31’ or ‘2024-12-31T23:59:59Z’)
integer
The estimated complexity or effort for the issue, represented as a numerical point value (e.g., 1, 2, 3, 5, 8). The specific scale used (e.g., Fibonacci, Linear, T-shirt sizes mapped to numbers) is defined by the team’s settings. This field only applies if the estimates feature is enabled for the team. A value of 0 typically means no estimate has been set.
integer
Priority of the issue. 0 indicates no priority, 1 is Urgent, 2 is High, 3 is Normal, and 4 is Low.
string
UUID of the workflow state to assign to the issue (must be a valid UUID format, not a state name like ‘backlog’ or ‘done’) Must belong to the same team as team_id — cross-team state UUIDs will be rejected.
array
A list of UUIDs for labels to be added to this issue. EXCLUSIVE GROUP CONSTRAINT: Linear organizes labels into groups where only ONE label per group can be applied. STEP-BY-STEP: (1) Call LINEAR_LIST_LINEAR_LABELS with team_id to get available labels. (2) FILTER OUT any labels where is_group=true (these are parent groups, not usable labels). (3) For remaining labels, group them by parent.id - labels with the SAME parent.id are mutually exclusive. (4) From each group with a shared parent.id, select ONLY ONE label. (5) Labels with parent=null can be freely combined. EXAMPLE: If labels A and B both have parent.id=‘X’, you can only use A OR B, not both. Always call LINEAR_LIST_LINEAR_LABELS with team_id to scope results — omitting team_id may return workspace-wide label IDs that are rejected for team-scoped issues.
string
UUID of an existing issue to set as the parent of this new issue, creating a sub-issue relationship (must be a valid UUID format)
string
UUID of the project to associate with this issue. Must be a valid UUID format (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx with 8-4-4-4-12 hex characters). IMPORTANT: The project must belong to the same team specified in team_id - Linear requires projects and issues to be in the same team. Use the LIST_LINEAR_PROJECTS action to find projects, then verify the project belongs to the target team before using it here.
string
UUID of the user to assign to this issue (must be a valid UUID format) User must be a member of the team specified in team_id.
string
A detailed description of the issue, which can include markdown formatting.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_CREATE_LINEAR_ISSUE_RELATIONCreate a relationship between two Linear issues using the issueRelationCreate mutation. Use this to establish connections like ‘blocks’, ‘duplicate’, or ‘related’ between issues.

Input Parameters

string
required
UUID of the primary issue in the relationship. Must be a valid Linear issue UUID (e.g., ‘c5748ccf-c67f-4af4-bd74-fe513dc4c054’). Use LINEAR_LIST_LINEAR_ISSUES or LINEAR_GET_LINEAR_ISSUE to retrieve valid issue UUIDs.
string ("blocks" | "duplicate" | "related")
required
Type of relationship between the two issues. Options: ‘blocks’ (this issue blocks the related issue), ‘duplicate’ (this issue is a duplicate of the related issue), ‘related’ (general relationship between issues).
UUID of the related issue. Must be a valid Linear issue UUID (e.g., ‘71bc4480-3aa1-4c56-b657-827996658662’). Use LINEAR_LIST_LINEAR_ISSUES or LINEAR_GET_LINEAR_ISSUE to retrieve valid issue UUIDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_CREATE_LINEAR_LABELCreates a label for a specified Linear team, or returns an existing exact-name match found in the team’s initial label results. The response includes an execution message when an existing label is returned.

Input Parameters

string
required
Name of the new label, displayed in the Linear UI. Must be unique within the team.
string
required
Hexadecimal color code (e.g., ‘#FF0000’) for the label’s appearance in the UI.
string
required
Identifier of the team for which this label will be created.
string
Optional detailed description for the label, providing context on its use.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_CREATE_LINEAR_PROJECTCreates a new Linear project with specified name and team associations.

Input Parameters

string
Optional icon for the project. Must be a valid icon name string from Linear’s icon set (case-sensitive). Does NOT accept unicode emoji characters. Verified valid icon names include: ‘Project’, ‘Rocket’, ‘Bug’, ‘Team’, ‘Calendar’, ‘Home’. Linear offers ~70 icon designs; invalid names will cause an INVALID_INPUT error.
string
required
The name of the project. This is the only required field. Linear permits duplicate project names within a team; uniqueness must be enforced externally if required.
string
Optional color for the project (hex color code).
string
Optional ID (UUID) of the user who will lead this project. User IDs can be obtained using the LINEAR_LIST_LINEAR_USERS action or from the team members returned by LINEAR_GET_ALL_LINEAR_TEAMS. Must be a valid UUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
integer
Priority level of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
array
required
List of team IDs (UUIDs) that this project will be associated with. At least one valid team ID is required. Team IDs can be obtained using the LINEAR_GET_ALL_LINEAR_TEAMS action. Must be valid UUIDs in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
string
Optional planned start date. Accepts various formats including YYYY-MM-DD, ISO datetime strings (e.g., 2024-01-15T10:30:00Z), or Unix timestamps. Will be normalized to YYYY-MM-DD format for the API. Use YYYY-MM-DD format only; ISO datetime strings and Unix timestamps cause validation failures despite being listed as accepted.
string
Optional description for the project. Supports markdown formatting. Maximum 255 characters (API limit: 255 accepted, 256 rejected).
string
Optional planned completion date. Accepts various formats including YYYY-MM-DD, ISO datetime strings (e.g., 2024-06-30T23:59:59Z), or Unix timestamps. Will be normalized to YYYY-MM-DD format for the API. Use YYYY-MM-DD format only; ISO datetime strings and Unix timestamps cause validation failures despite being listed as accepted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_CREATE_PROJECT_MILESTONETool to create a project milestone in Linear with a name and optional target date and sort order. Use when you need to add milestones to track progress within a project.

Input Parameters

string
required
The name/title of the milestone. This is a required field.
string
required
UUID of the project to which this milestone belongs. Must be a valid UUID format (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Use LINEAR_LIST_LINEAR_PROJECTS or LINEAR_GET_LINEAR_PROJECT to find valid project UUIDs.
number
Optional sort order number for the milestone. Lower numbers appear first. This determines the display order of milestones within a project.
string
Optional description for the milestone. Supports markdown formatting.
string
Optional target date for the milestone in YYYY-MM-DD format. Accepts date strings in the format YYYY-MM-DD only (e.g., ‘2024-06-30’). ISO datetime strings or Unix timestamps are not supported by Linear’s projectMilestoneCreate mutation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_CREATE_PROJECT_UPDATETool to create a project status update post for a Linear project. Use when you need to post progress updates, status reports, or announcements for a project.

Input Parameters

string
required
The body content of the project update. Supports markdown formatting. This is the main content describing the project status, progress, blockers, and next steps.
string ("onTrack" | "atRisk" | "offTrack")
Health status for a project update in Linear.
string
required
The unique identifier (UUID) of the project to create an update for. Must be a valid Linear project UUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Use LINEAR_LIST_LINEAR_PROJECTS or LINEAR_GET_LINEAR_PROJECT to retrieve valid project UUIDs.
boolean
Optional flag to control whether the diff (changes since last update) should be hidden in the update. If true, the diff will not be displayed. If false or not provided, the diff will be shown by default.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_CREATE_TEAMCreates a new team in Linear with the specified name and key. Use this action when you need to create a new organizational unit or work group in a Linear workspace. Teams are fundamental organizational structures in Linear that group issues, projects, and members together. Once created, the team’s key becomes the prefix for all issues created within that team (e.g., ‘ENG-123’). IMPORTANT: The key must be unique across the workspace and cannot be changed after creation.

Input Parameters

string
required
The unique key/slug for the team. This is used as a short identifier in issue identifiers (e.g., ‘ENG-123’ for the Engineering team). Must be 2-5 uppercase letters, alphanumeric only. Once set, the key becomes the prefix for all issues in this team.
string
Optional icon for the team. Must be a valid icon name string from Linear’s icon set (case-sensitive). Does NOT accept unicode emoji characters. Common valid icon names include: ‘Team’, ‘Users’, ‘Bolt’, ‘Rocket’, ‘Bug’, ‘Shield’, ‘Terminal’, ‘Chip’. Invalid names will cause an INVALID_INPUT error.
string
required
The name of the team. This is the primary identifier visible to users in the Linear workspace. Team names should be descriptive and help identify the team’s purpose or area of responsibility.
string
Optional color for the team (hex color code without the # prefix, or with the # prefix). Used for visual identification in the Linear interface.
boolean
Whether the team should be private. Private teams are only visible to team members. Default is False (public team visible to all workspace members).
string
Optional description of the team’s purpose, responsibilities, or scope. Supports markdown formatting. Helps team members understand the team’s role in the organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_DELETE_LINEAR_ISSUEArchives an existing Linear issue by its ID, which is Linear’s standard way of deleting issues; the operation is idempotent. Archiving is permanent with no built-in undo — confirm the issue identifier and title with the user before executing, especially in bulk operations.

Input Parameters

string
required
ID of the Linear issue to be archived. Must be in one of two formats: (1) UUID format: a 36-character string with hyphens (e.g., ‘c5748ccf-c67f-4af4-bd74-fe513dc4c054’), or (2) Shorthand identifier: team key (alphanumeric, must start with a letter, 1-10 chars) followed by hyphen and issue number (e.g., ‘ENG-123’, ‘MAN8-456’). Note: Plain numeric IDs are NOT valid Linear issue identifiers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_GET_ALL_LINEAR_TEAMSDEPRECATED: Use ListLinearTeams instead (returns paginated payloads with members and projects); this tool returns simpler id/name-level data for all teams visible to the connected workspace with no server-side filtering. Match teams on stable team id, not display name, as names are not guaranteed unique. Partial results reflect workspace permission scope, not tool failure. Skip this call if team_id values are already known.

Input Parameters

string
Cursor for pagination. Use the endCursor from the previous response’s page_info to fetch the next page.
integer
Number of teams to return per page. Use with after to paginate through all teams.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_GET_ATTACHMENTDownloads a Linear Attachment record or a private upload embedded in issue/comment Markdown; file_name must include the correct extension.

Input Parameters

string
The Linear issue identifier containing an Attachment record. Required with attachment_id; omit when using upload_url.
string
required
The desired name for the downloaded file, including its extension.
string
An https://uploads.linear.app/... URL embedded in an issue description or comment body. Use this to download inline screenshots and other uploaded files that are not present in the issue’s attachments list.
string
The ID of an Attachment record returned by LINEAR_GET_LINEAR_ISSUE. Required with issue_id; omit when using upload_url.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_GET_COMMENTRetrieves a single Linear comment by its unique ID. Returns comprehensive details including the comment body, author, timestamps, associated issue, and thread information. Use this action when you need to fetch details about a specific comment, such as when displaying comment information, checking comment status, or retrieving comment content for processing. The comment ID can be obtained from issue queries, comment lists, or comment creation responses.

Input Parameters

string
required
Unique identifier of the comment to retrieve. Must be a valid UUID format comment ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_GET_CURRENT_USERGets the currently authenticated Linear user’s ID, name, email, and other profile information. The account behind the token may be a bot or service account; the user ID is returned under user.id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_GET_CYCLES_BY_TEAM_IDLists cycles for a specified Linear team ID, including progress, creation and end times, and history. Results are paginated; follow page_info cursors to retrieve subsequent pages.

Input Parameters

string
Cursor for pagination. Use the endCursor value from the previous response’s page_info to fetch the next page.
integer
Number of cycles to return per page. Maximum 250. Use with after to paginate through all cycles.
string
required
The team’s unique identifier. Must be a valid UUID (e.g., ‘d282d590-8462-4390-8ef9-98f5ac2190b0’), not a human-readable name or slug; use LINEAR_GET_ALL_LINEAR_TEAMS to resolve if unknown.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_GET_ISSUE_DEFAULTSFetches a Linear team’s default issue estimate and state, useful for pre-filling new issue forms.

Input Parameters

string
required
Identifier of the Linear team. Must be a valid UUID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_GET_LINEAR_ISSUERetrieves a Linear issue by UUID or shorthand identifier, including its details, parent, cycle, attachments, comments and subscribers. Optional related fields may be null; certain issue-not-found errors return a null issue with an explanatory message.

Input Parameters

string
required
ID of the Linear issue. Must be in one of two formats: (1) UUID format: a 36-character string with hyphens (e.g., ‘c5748ccf-c67f-4af4-bd74-fe513dc4c054’), or (2) Shorthand identifier: team key (alphanumeric, must start with a letter, 1-10 chars) followed by hyphen and issue number (e.g., ‘ENG-123’, ‘MAN8-456’). Note: Plain numeric IDs are NOT valid Linear issue identifiers. Use LIST_LINEAR_ISSUES action to retrieve valid issue IDs if needed. Full URLs are also invalid and must be resolved to UUID or shorthand format first.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_GET_LINEAR_PROJECTRetrieves a single Linear project by its unique identifier. Use when verifying a newly created or updated project, or when fetching detailed project information by ID.

Input Parameters

string
required
The unique identifier (UUID) of the Linear project to retrieve.
boolean
Whether to include teams associated with the project in the response.
boolean
Whether to include project members in the response.
boolean
Whether to include related initiatives in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_GET_PROJECT_UPDATERetrieves a specific project update by its unique identifier. Use when you need to fetch details about a specific project status update, including the update content, health status, timestamps, and associated project information. This action is useful when verifying a newly created project update or retrieving historical project update information.

Input Parameters

string
required
The unique identifier (UUID) of the project update to retrieve. Must be a valid Linear project update UUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_COMMENTSLists comments from Linear workspace accessible to the authenticated user. Use this action when you need to retrieve comments for analysis, reporting, or tracking discussions across issues. The response includes comment content, timestamps, author information, and associated issue details. Supports pagination for large result sets.

Input Parameters

string
Cursor for forward pagination. Use the exact endCursor value from the previous response’s page_info to fetch the next page of comments. Do not modify the cursor value.
integer
Number of comments to return per page. Maximum 250. Use pagination to retrieve more comments by passing page_info.endCursor as the after parameter in subsequent requests.
string
Cursor for backward pagination. Use the exact startCursor value from the previous response’s page_info to fetch the previous page of comments.
boolean
Whether to include archived comments in the results. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_ISSUE_DRAFTSLists the connected user’s issue drafts for review or editing. Results are paginated; check page_info.hasNextPage for additional drafts.

Input Parameters

string
Cursor for pagination. Use the endCursor from the previous response’s pageInfo to fetch the next set of drafts.
integer
Number of draft issues to return.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_ISSUES_BY_TEAM_IDTool to list all issues for a specific Linear team, scoped by team ID. Use when you need to retrieve issues belonging to a particular team without fetching workspace-wide issues. This is more efficient than workspace-wide listing followed by client-side filtering.

Input Parameters

string
Opaque pagination cursor for fetching the next page of results. MUST be the exact end_cursor value from a previous response’s page_info. Cannot use issue IDs, UUIDs, or arbitrary strings. Omit for the first page.
integer
Number of issues to return per page (forward pagination). Must be between 1 and 250.
string
required
The unique identifier (UUID) of the Linear team whose issues you want to list. This is the team’s ID, not the team’s name or key.
boolean
Whether to include archived issues in the results. Default is false (only active issues are returned).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_LINEAR_CYCLESLists cycles across the Linear account without filters, including team IDs and scheduled end times. Results are paginated; use page_info.endCursor and hasNextPage to retrieve subsequent pages.

Input Parameters

string
Cursor for pagination. Use the endCursor from the previous response’s page_info to fetch the next page.
integer
Number of cycles to return per page. Use with after to paginate through all cycles.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_LINEAR_ISSUESLists non-archived Linear issues with optional project and assignee filters, returning a paginated issues array and page_info. Issues include due dates; optional transition history includes completion timestamps and may be truncated or report per-issue errors.

Input Parameters

string
Cursor for pagination (opaque string). Use the exact endCursor value from the previous response’s page_info to fetch the next set of issues. Do not modify, prefix, or transform the cursor value in any way.
integer
Number of issues to return. Maximum 250 per page. To retrieve all issues, loop using page_info.hasNextPage and pass page_info.endCursor as after until hasNextPage is false.
string
ID of the project to filter issues by. If provided, only issues belonging to this project will be returned. Must be a valid project ID that exists and is accessible to the authenticated user.
string
UUID of the user to filter issues by assignee. Use ‘me’ to filter by the current authenticated user, or provide a valid Linear user UUID (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Use LINEAR_GET_CURRENT_USER to get your own ID, or LINEAR_LIST_LINEAR_USERS to retrieve other user UUIDs. Note: ‘me’, ‘@me’, and email addresses are NOT accepted; only a valid UUID or the literal string ‘me’ if supported — use LINEAR_GET_CURRENT_USER to obtain your UUID.
string
The original cursor value before it was reset.
boolean
When true, includes the full status transition history for each issue, along with timestamps and computed time-in-state durations. When false (default), the tool returns the standard limited issue object with no transition data. Enabling this increases response size and GraphQL query complexity — when true, first is internally capped at 25 and values above 50 return a structured error.
boolean
Indicates whether the pagination cursor was corrupted and reset.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_LINEAR_LABELSRetrieves paginated Linear issue labels for a specified team or across the workspace. Use page_info.hasNextPage and page_info.endCursor to fetch further pages.

Input Parameters

string
Cursor for pagination. Use the endCursor value from the previous response’s page_info to fetch the next page.
integer
Number of labels to return per page. Maximum 250. Use with after to paginate through all labels.
string
The unique identifier of the team for which to retrieve labels. If provided, returns labels scoped to that specific team. If omitted, returns all labels across the workspace. Workspace-wide label IDs (returned when team_id is omitted) may not be valid for team-scoped mutations like LINEAR_CREATE_LINEAR_ISSUE or LINEAR_UPDATE_ISSUE; pass the relevant team_id to get labels valid for that team.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_LINEAR_PROJECTSRetrieves all projects from the Linear account. Returns a flat array (not a GraphQL connection) with fields id and name; use LINEAR_RUN_QUERY_OR_MUTATION for progress, state, issues, or team linkage. No server-side filtering: all workspace projects are returned regardless of team or name — filter client-side. Multiple projects can share identical names; always confirm project_id before downstream use. Results are permission-scoped to the connected user. Pagination: loop while page_info.hasNextPage is true, passing page_info.endCursor as after, or results will be silently truncated. HTTP 429 may occur in large workspaces; apply exponential backoff between calls.

Input Parameters

string
Cursor for pagination. Use the endCursor from the previous response’s page_info to fetch the next page.
integer
Number of projects to return per page. Use with after to paginate through all projects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_LINEAR_STATESRetrieves all workflow states for a specified team in Linear, representing the stages an issue progresses through in that team’s workflow. Returned state IDs are team-scoped — never reuse a stateId across different teams, as this causes validation errors or ‘Entity not found’ failures in tools like LINEAR_UPDATE_ISSUE. State names (e.g., ‘Done’, ‘In Progress’) are non-unique across teams; always resolve names to IDs via this tool for the specific team_id before using them in filters or mutations. Uses cursor-based pagination via pageInfo.hasNextPage and endCursor; iterate until hasNextPage is false to avoid missing states in large workspaces. Always fetch fresh state IDs rather than hardcoding or reusing stale values.

Input Parameters

string
Cursor for pagination. Use the endCursor value from the previous response’s page_info to fetch the next page.
integer
Number of states to return per page. Maximum 250. Use with after to paginate through all states.
string
required
UUID of a team in your Linear workspace. Must be a valid UUID (e.g., ‘2a6e9b1b-19cd-4e30-b5bd-7b34dc491c7e’). To find valid team IDs, first use the ‘Get all teams’ or ‘Get teams’ action to list teams in your workspace.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_LINEAR_TEAMSLists visible Linear teams with their members and project IDs, with pagination for teams but not nested members or projects. An optional project ID filters each team’s projects rather than the teams themselves.

Input Parameters

string
Cursor for pagination. Use the endCursor value from the previous response’s page_info to fetch the next page.
integer
Number of teams to return per page. Maximum 250. Use with after to paginate through all teams.
string
Optional project ID to filter teams’ associated projects. If provided, only projects matching this ID will be included in each team’s ‘projects’ list. If not provided, all projects for each team will be returned. Filtering is applied per-team after fetch; a project_id belonging to a different team silently returns an empty projects list rather than an error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_LINEAR_USERSLists workspace users with IDs, names, emails, and active status. Results are paginated; use the returned cursor to retrieve subsequent pages.

Input Parameters

string
Cursor for pagination. Use the endCursor from the previous response’s page_info to fetch the next set of users.
integer
Number of users to return. In large workspaces, check page_info.hasNextPage and paginate using after; omitting pagination silently drops users beyond this limit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_LIST_PROJECT_UPDATESRetrieves all project updates from the Linear workspace. Project updates are status posts written by team members to communicate project progress, blockers, and health. Use when you need to fetch project update history, track project health over time, or review team communication. Returns a paginated list with fields including id, body, health, createdAt, url, user, and project. Results are permission-scoped to the connected user — only updates from accessible projects are returned. Pagination: loop while page_info.hasNextPage is true, passing page_info.endCursor as after, or results will be silently truncated. HTTP 429 may occur in large workspaces; apply exponential backoff between calls.

Input Parameters

string
Cursor for pagination. Use the endCursor from the previous response’s page_info to fetch the next page.
integer
Number of project updates to return per page. Use with after to paginate through all updates.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_REMOVE_ISSUE_LABELRemoves a specified label from a Linear issue using the issue and label IDs, and returns the updated issue and labels. If the label is absent, the label set is unchanged. The operation replaces the fetched label set, so concurrent label changes may be overwritten.

Input Parameters

string
required
Identifier of the Linear issue from which to remove the label. Verify this is the correct issue before executing; wrong IDs can silently remove labels from unintended issues without error.
string
required
Identifier of the label to remove. The operation is successful without change if this label isn’t on the issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_REMOVE_REACTIONTool to remove a reaction on a comment. Use when you have a reaction ID and need to delete it.

Input Parameters

string
required
Identifier of the reaction to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_RESOLVE_COMMENTMarks a Linear comment as resolved. This action is used when a comment thread or discussion has been addressed and should be marked as complete. Use this action when you need to resolve a comment after addressing the feedback or discussion it represents. The comment remains visible but is marked as resolved with a timestamp and the resolving user’s information.

Input Parameters

string
required
The ID of the comment to resolve. Must be a valid UUID format (e.g., ‘c5ac5ead-ae3b-4d54-8c5b-9ca103896021’). Use LIST_LINEAR_ISSUES or GET_LINEAR_ISSUE to retrieve issue comments and their IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_RUN_QUERY_OR_MUTATIONExecute a Linear GraphQL query or mutation to retrieve or change accessible data. Use it for custom filtering, schema introspection, or operations without a dedicated action. When an operation partially succeeds, the response can include both data and errors.

Input Parameters

object
Variables for the GraphQL operation as a JSON object. Optional - omit this field or use {} if no variables are needed. RULES: - Keys must match variable names in query (without ’$’ prefix) - Types must align with query definition (String/Int/Boolean/ID/DateTime/arrays) - ID-type variables: Declare as ID in query ($projectId: ID!), but pass as string in variables dict Example: query has “$teamId: ID!” -> variables {“teamId”: “TEAM_UUID”} - ID-type variables (e.g., issueId, teamId, stateId) must not be empty strings ERROR RECOVERY: - If query with variables fails, test with variables={} first to confirm query syntax is valid - Verify IDs exist by querying for them before using in mutations
string
required
GraphQL query or mutation for Linear’s API. Must be a non-empty, valid GraphQL query or mutation string. RULES (each prevents a silent failure or hard-to-debug error): 1. INTROSPECTION FIRST: Never guess field/mutation names. Run __type introspection before any uncertain operation. 2. INPUT vs OUTPUT naming: Query outputs use nested objects (lead { id name }), but mutation inputs use scalar ID fields (leadId: “UUID”). Using lead: { id: ”…” } in input causes “Did you mean leadId?” errors. 3. POLYMORPHIC TYPES: Interfaces/unions (e.g., Notification) require inline fragments for subtype-specific fields. Use … on IssueNotification { issue { id } } instead of querying issue directly on Notification. 4. NO totalCount: Connection types have only nodes and pageInfo. totalCount does not exist (unlike GitHub/GitLab). 5. DEPRECATED issueSearch: Use issues(filter: {…}) or searchIssues(term: “text”) instead. issueSearch returns INPUT_ERROR. 6. FILTER OPERATORS: Use nin (NOT notIn) for “not in array”. Use eq/neq/in/nin/contains/gt/gte/lt/lte. STRING CASE SENSITIVITY (CRITICAL): ALL string operators (eq, neq, contains, startsWith, endsWith, etc.) are case-sensitive. Linear provides NO case-insensitive operators (eqCaseInsensitive, containsCaseInsensitive, etc. do NOT exist). For state name matching, query exact state names or use state.type field. For user/entity search, prefer contains with exact casing or query first then filter. 7. SORT vs ORDERBY (MUTUALLY EXCLUSIVE - use ONE or the OTHER, NEVER both): - orderBy: Simple enum values for common sorting (createdAt, updatedAt). Example: orderBy: createdAt - sort: Complex objects for manual ordering with granular control. Example: sort: [{ manual: { order: Ascending } }] - CRITICAL: Using both simultaneously causes INPUT_ERROR: “Cannot use both sort and orderBy options” - Use Ascending/Descending (capitalized) for sort enums, NOT asc/desc 8. LABELS ARE TEAM-SCOPED: No root-level labels query. Access via teams { nodes { labels { nodes { … } } } }. Never use isGroup:true labels directly. 9. LABEL FILTERS: No ‘none’ operator. Use labels: { length: { eq: 0 } } for issues with no labels. Available: some (default), every, length, null. 10. SEARCH: searchIssues(term: “text”) - term is required String!, NOT ‘query’. 11. DATE TYPES: Date filters use DateTimeOrDuration! (not DateTime!). TimelessDate=“YYYY-MM-DD” for project dates. DateTime=“2024-01-15T10:30:00Z”. 12. ID EXCEPTIONS: team(id:), project(id:), issue(id:), issueUpdate(id:) use String!, not ID!. Entity IDs in filters use ID! type. 13. PROJECT.LEAD: Singular User object (nullable), NOT a connection. Use lead { id name }, NOT leads { nodes { … } }. 14. PROJECT.STATE: Scalar String (“planned”, “started”, etc.), not an object. Use statusId (not ‘state’) in ProjectCreateInput/ProjectUpdateInput. 15. PROJECT FILTER: Use accessibleTeams.some, NOT ‘team’. Example: { accessibleTeams: { some: { key: { eq: “ENG” } } } } 16. CYCLE.PROGRESS: Scalar Float (0.0-1.0), NOT an object. Use currentProgress for detailed scope data. 17. INTEGRATION FIELDS: Only id, service, createdAt, updatedAt, archivedAt, organization, team, creator. No key/name/type/url/description fields. 18. DOCUMENTCONTENT vs DOCUMENTS: documentContent is inline content body (no title field). documents is the connection with title/summary metadata. 19. DELETE PAYLOADS: Most return DeletePayload { success entityId }. Issue/project deletes return ArchivePayload { success entity { id } }. Use introspection if unsure. 20. DOCUMENT CREATE: Requires at least one relation field (projectId, issueId, teamId, etc.) or you get INVALID_INPUT. 21. FILE UPLOAD: uploadUrl/assetUrl are nested under uploadFile, NOT direct fields on UploadPayload. 22. WEBHOOKS: webhookCreate requires EITHER teamId OR allPublicTeams: true. 23. COMMENTS: commentCreate uses issueId (NOT projectId). Use parentId for replies. 24. QUERY COMPLEXITY: Max 10,000 points. Use first: 10-25 with nested connections. “Query too complex” = reduce pagination or nesting. 25. CONNECTIONS: *Connection/*SearchPayload types need nodes wrapper. Other Payloads don’t. 26. FILTER SYNTAX: { field: { eq: value } }, { or: […] } (lowercase ‘or’). NULL checks: { field: { eq: null } } or { neq: null }. 27. INITIATIVE STATUS: Use bare enum in mutations (status: Active), quoted string in filters (status: { eq: “Active” }). 28. CUSTOMVIEW: Has NO ‘url’ field (unlike Issue). Use slugId for identification. ERROR RECOVERY: On field errors, run __type introspection. On enum errors, introspect the enum. On complexity errors, reduce pagination. Docs: https://developers.linear.app/docs/graphql/working-with-the-graphql-api

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_SEARCH_ISSUESSearches Linear issues by full-text query, with pagination and an option to include archived issues.

Input Parameters

string
Cursor for pagination. Use the endCursor from the previous response’s page_info to fetch the next page of results.
integer
Number of issues to return per page. Must be between 1 and 50. Defaults to 25.
string
required
The search query text. Searches across issue identifier (e.g., ‘ENG-123’), title, and description fields. This is a full-text search only; structured filtering by team, project, assignee, state, or labels is NOT supported on this endpoint. Use LIST_ISSUES_BY_TEAM_ID for filtered queries.
boolean
Whether to include archived issues in search results. Defaults to false (only active issues).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_UNARCHIVE_PROJECT_UPDATEUnarchive a previously archived project update in Linear. Use this action when you need to restore an archived project update to make it visible and active again. Archived project updates are hidden from normal views but can be restored using this action. Use when a project update was archived by mistake or needs to be brought back into active use.

Input Parameters

string
required
The unique identifier (UUID) of the project update to unarchive. Must be a valid Linear project update UUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_UNRESOLVE_COMMENTUnresolves a previously resolved Linear comment, marking it as requiring attention again. Use this action when you need to reopen a comment thread that was previously marked as resolved. This is useful when additional discussion is needed or the resolution was premature.

Input Parameters

string
required
Unique identifier of the comment to unresolve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_UPDATE_ISSUEUpdates an existing Linear issue by ID, requiring at least one field to modify; supplied fields overwrite existing values and labels replace the label set. A team move combined with a state, project, or cycle update runs in two phases, so an error may leave the first phase applied.

Input Parameters

string
New title for the issue.
string
UUID of the team to move the issue to. Use this to transfer an issue from one team to another. The team must exist in your workspace and you must have access to it. Use the GET_ALL_LINEAR_TEAMS or LIST_LINEAR_TEAMS action to get valid team IDs.
string
UUID of the cycle (sprint) to assign this issue to. Must be a valid UUID in the format ‘xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx’. IMPORTANT: Cycles are team-scoped in Linear. The cycle must belong to the same team as the issue, otherwise the API will reject the request with an error. Use GET_CYCLES_BY_TEAM_ID with the issue’s team_id to get valid cycle IDs.
string
New due date in ISO8601 datetime format or YYYY-MM-DD TimelessDate format (e.g., ‘2024-12-31’ or ‘2024-12-31T23:59:59Z’)
string
required
Identifier of the issue to update. Accepts either UUID format (e.g., ‘d282c513-3265-4513-9099-abc0123def45’) or issue key format (e.g., ‘ENG-123’, ‘BLA-456’).
string
UUID of the workflow state to transition the issue to. Must be a valid UUID in the format ‘xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx’ (e.g., ‘f47ac10b-58cc-4372-a567-0e02b2c3d479’). Do NOT use state names like ‘To Do’, ‘In Progress’, or ‘Done’. IMPORTANT: Workflow states are team-scoped in Linear. The state must belong to the same team as the issue, otherwise the API will reject the request with an error. Use LIST_LINEAR_STATES with the issue’s team_id to get valid state IDs.
integer
Estimate points for the issue (e.g., 1, 2, 3, 5, 8). Teams may use different estimation types: exponential, fibonacci, linear, or t-shirt sizing.
array
List of label identifiers to set; replaces all existing labels. An empty list removes all labels.
string
UUID of an existing issue to set as this issue’s parent (making this issue a sub-issue). The parent issue must not create a circular dependency (e.g., the parent cannot be this issue itself or one of its descendants), and you must have access to it. Sub-issues can be assigned to any team in the workspace.
integer
Priority: 0 (No), 1 (Urgent), 2 (High), 3 (Normal), 4 (Low).
string
UUID of the project to associate the issue with. Must be a valid UUID in the format ‘xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx’. IMPORTANT: Projects are team-scoped in Linear. The project must belong to the same team as the issue, otherwise the API will reject the request with an error. Use LINEAR_LIST_LINEAR_PROJECTS action to get valid project IDs and LINEAR_GET_LINEAR_PROJECT with include_teams=true to verify a project’s team.
string
UUID of the user to assign to the issue. Must be a valid user UUID from your Linear workspace (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Use LIST_LINEAR_USERS to get valid user IDs. Do NOT use placeholder values like ‘<DATE_TIME>’ or ‘{USER_ID}’.
string
New Markdown description for the issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_UPDATE_LINEAR_COMMENTTool to update an existing Linear comment’s body text. Use when you need to edit or modify the content of a previously created comment.

Input Parameters

string
required
New comment content, in plain text or Markdown format.
string
required
Unique identifier of the comment to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_UPDATE_LINEAR_PROJECTTool to update an existing Linear project. Use when you need to modify project properties like name, description, state, dates, or lead. All fields except project_id are optional - only provide the fields you want to update.

Input Parameters

string
Icon identifier for the project.
string
New name for the project.
string
Color for the project (hex color code).
string
The state of the project. Standard values: ‘backlog’, ‘planned’, ‘started’, ‘completed’, ‘canceled’. Note: Some workspaces may have custom states configured.
string
The UUID of the user who will lead this project. Must be a valid Linear user UUID. Use the LIST_LINEAR_USERS action to get valid user IDs.
integer
Priority level of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
string
The UUID of the project status to set. Must be a valid Linear project status UUID.
string
required
The unique identifier (UUID) of the project to update. This is the internal Linear ID, not the project slug or name.
string
New planned start date. Accepts various formats including YYYY-MM-DD, ISO datetime strings (e.g., 2024-01-15T10:30:00Z), or Unix timestamps. Will be normalized to YYYY-MM-DD format for the API.
string
New description for the project. Supports plain text.
string
New planned completion date. Accepts various formats including YYYY-MM-DD, ISO datetime strings (e.g., 2024-06-30T23:59:59Z), or Unix timestamps. Will be normalized to YYYY-MM-DD format for the API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_UPDATE_PROJECT_UPDATETool to update an existing Linear project update post. Use this action when you need to modify a project update’s content, health status, or diff visibility settings. All fields except the update ID are optional - only provide the fields you want to update. Changes are immediately visible to all team members viewing the project.

Input Parameters

string
required
The unique identifier (UUID) of the project update to update. Must be a valid Linear project update UUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
string
The new body content of the project update. Supports markdown formatting. This is the main content describing the project status, progress, blockers, and next steps.
string ("onTrack" | "atRisk" | "offTrack")
Health status for a project update in Linear.
boolean
Optional flag to control whether the diff (changes since last update) should be hidden in the update. If true, the diff will not be displayed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_UPDATE_TEAMUpdates an existing Linear team’s settings, including its name, key, cycle settings, and workflow state configuration. At least one update field must be provided.

Input Parameters

string
New unique key/slug for the team. This is used in issue identifiers (e.g., ‘ENG’ for ‘ENG-123’). Must be uppercase letters only, typically 2-5 characters.
string
New icon identifier for the team. Must be a valid Linear icon name (e.g., ‘Chip’, ‘Database’, ‘Rocket’, ‘Code’, ‘Palette’), not an emoji.
string
New name for the team.
string
New color for the team (hex color code).
boolean
Whether the team is private (visible only to members) or public (visible to all workspace members).
string
required
The unique identifier (UUID) of the team to update. This is the internal Linear team ID, not the team key or name. Use LINEAR_GET_ALL_LINEAR_TEAMS or LINEAR_LIST_LINEAR_TEAMS to get valid team IDs.
string
Timezone for the team (e.g., ‘America/Los_Angeles’, ‘Europe/London’, ‘UTC’).
string
New description for the team. Supports plain text.
integer
Duration of cycles (sprints) in weeks for this team.
integer
Day of the week when cycles (sprints) start for this team. 0 = Monday, 1 = Tuesday, …, 6 = Sunday.
boolean
Whether triage mode is enabled for this team. When enabled, new issues go into a triage state first.
number
Number of months after which inactive issues in certain states are automatically closed. Set to 0 to disable auto-closing.
string
UUID of the workflow state to transition issues to when they are auto-closed.
number
Number of months after which completed issues are automatically archived. Set to 0 to disable auto-archiving.
integer
Cooldown period in minutes at the end of each cycle before the next cycle starts.
boolean
Whether to lock issues to the active cycle, preventing them from being moved to other cycles.
integer
Number of upcoming cycles to create automatically. Must be one of: 1, 2, 3, 4, 6, 8, 10, 12, 15.
string
UUID of the workflow state for draft issues in this team.
string
UUID of the workflow state for merged issues.
string
UUID of the workflow state that marks when work on an issue starts.
string
UUID of the workflow state for issues under review.
boolean
Whether to automatically assign started issues to the current cycle.
boolean
Whether to automatically assign completed issues to the current cycle.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_VALIDATE_CREDENTIALValidates the Linear API credentials by checking if the authentication token can successfully query the current user. Use this action when you need to verify that API credentials are valid before performing other operations, or to confirm that authentication is working correctly. This is particularly useful for connection testing, credential verification flows, or troubleshooting authentication issues.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LINEAR_WHO_AM_IReturn the identity (name, email) of the connected Linear account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: LINEAR_COMMENT_EVENT_TRIGGERType: webhookTriggered when a comment is received.

Configuration

string
required
ID of the team to filter issues by

Payload

string
required
Action that triggered the webhook
object
required
Data of the issue
string
required
Type of the issue
string
required
URL of the issue
Slug: LINEAR_ISSUE_CREATED_TRIGGERType: webhookTriggered when a new issue is created.

Configuration

string
required
ID of the team to filter issues by

Payload

string
required
Action that triggered the webhook
object
required
Data of the issue
string
required
Type of the issue
string
required
URL of the issue
Slug: LINEAR_ISSUE_UPDATED_TRIGGERType: webhookTriggered when an issue is updated. For example labels are changed, issue status is changed, etc.

Configuration

string
required
ID of the team to filter issues by

Payload

string
required
Action that triggered the webhook
object
required
Data of the issue
string
required
Type of the issue
string
required
URL of the issue
Slug: LINEAR_PRIVATE_TEAM_COMMENT_CREATEDType: pollFires when a new comment is posted on an issue in a private Linear team (polled with the connected user’s token).

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
required
UUID of the private Linear team to monitor. The connected user must be a member. Use LINEAR_LIST_LINEAR_TEAMS to discover valid team UUIDs.

Payload

string
required
Comment body in markdown.
string
required
ISO 8601 timestamp.
string
required
Comment UUID.
object
required
Issue the comment was posted on.
object
Lightweight reference to a parent comment. Linear’s GraphQL Comment.parent is itself a full Comment type (carries body, user, createdAt, …); we only query id today because that’s what current customer use-cases need. Kept as a relation object — not flattened to a scalar — so a future need to surface the parent’s body or author can extend this class + _TEAM_COMMENTS_QUERY without breaking the canonical model.
string
required
ISO 8601 timestamp.
string
Comment URL.
object
Reference to a Linear workspace member (assignee, creator, comment author).
Slug: LINEAR_PRIVATE_TEAM_ISSUE_CREATEDType: pollFires when a new issue appears in a private Linear team (polled with the connected user’s token).

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
required
UUID of the private Linear team to monitor. The connected user must be a member. Use LINEAR_LIST_LINEAR_TEAMS to discover valid team UUIDs.

Payload

object
Reference to a Linear workspace member (assignee, creator, comment author).
string
required
ISO 8601 creation timestamp.
object
Reference to a Linear workspace member (assignee, creator, comment author).
string
Issue description in markdown; may be empty.
number
Issue point estimate.
string
required
Issue UUID.
string
required
Human-readable Linear identifier, e.g. ENG-123.
array
required
Labels attached to the issue.
integer
Sequential issue number within the team.
integer
required
Priority value (0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low).
string
Human-readable priority label.
object
Lightweight reference to a project.
object
required
Current workflow state.
object
required
Team the issue belongs to.
string
required
Issue title.
string
required
ISO 8601 last-update timestamp.
string
required
Linear web URL of the issue.
Slug: LINEAR_PRIVATE_TEAM_ISSUE_PROPERTIES_UPDATEDType: pollFires when properties on an issue change in a private Linear team (polled with the connected user’s token).

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
required
UUID of the private Linear team to monitor. The connected user must be a member. Use LINEAR_LIST_LINEAR_TEAMS to discover valid team UUIDs.

Payload

object
Reference to a Linear workspace member (assignee, creator, comment author).
string
required
ISO 8601 creation timestamp.
object
Reference to a Linear workspace member (assignee, creator, comment author).
string
Issue description in markdown; may be empty.
number
Issue point estimate.
string
required
Issue UUID.
string
required
Human-readable Linear identifier, e.g. ENG-123.
array
required
Labels attached to the issue.
integer
Sequential issue number within the team.
integer
required
Priority value (0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low).
string
Human-readable priority label.
object
Lightweight reference to a project.
object
required
Current workflow state.
object
required
Team the issue belongs to.
string
required
Issue title.
string
required
ISO 8601 last-update timestamp.
string
required
Linear web URL of the issue.
Slug: LINEAR_PROJECT_CREATEDType: pollFires when a new Linear project is created. Covers projects in both public and private teams — polls with the connected user’s token, so visibility matches what the connected user can see in Linear.

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
Hex color of the project.
string
required
ISO 8601 timestamp.
object
Reference to a Linear workspace member (assignee, creator, comment author).
string
Project description; may be empty.
string
required
Project UUID.
object
Reference to a Linear workspace member (assignee, creator, comment author).
string
required
Project name.
integer
Priority value, same scale as issues (0=None…4=Low).
string
Planned start date (YYYY-MM-DD).
string
High-level lifecycle state (backlog, planned, started, paused, completed, canceled).
string
Planned target date (YYYY-MM-DD).
array
required
Teams the project spans (one or more).
string
required
ISO 8601 timestamp.
string
required
Linear web URL of the project.
Slug: LINEAR_PROJECT_PROPERTIES_UPDATEDType: pollFires when properties on a Linear project change (status, lead, target date, priority, etc.). Covers projects in both public and private teams — polls with the connected user’s token.

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
Optional Linear project UUID. When set, polls only this project. Use LINEAR_LIST_LINEAR_PROJECTS to discover valid project UUIDs.

Payload

string
Hex color of the project.
string
required
ISO 8601 timestamp.
object
Reference to a Linear workspace member (assignee, creator, comment author).
string
Project description; may be empty.
string
required
Project UUID.
object
Reference to a Linear workspace member (assignee, creator, comment author).
string
required
Project name.
integer
Priority value, same scale as issues (0=None…4=Low).
string
Planned start date (YYYY-MM-DD).
string
High-level lifecycle state (backlog, planned, started, paused, completed, canceled).
string
Planned target date (YYYY-MM-DD).
array
required
Teams the project spans (one or more).
string
required
ISO 8601 timestamp.
string
required
Linear web URL of the project.
Slug: LINEAR_PROJECT_UPDATE_POSTEDType: pollFires when a project status update is posted on the Linear project’s Updates tab. Covers projects in both public and private teams — polls with the connected user’s token.

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
Optional Linear project UUID. When set, polls only this project. Use LINEAR_LIST_LINEAR_PROJECTS to discover valid project UUIDs.

Payload

string
required
Project update body in markdown.
string
required
ISO 8601 timestamp.
string
required
Project health label (onTrack, atRisk, offTrack).
string
required
Project update UUID.
object
required
Parent project reference.
string
required
ISO 8601 timestamp.
object
Reference to a Linear workspace member (assignee, creator, comment author).
Slug: LINEAR_PUBLIC_TEAM_COMMENT_CREATEDType: webhookFires when a new comment is posted on a public-team Linear issue. For private teams (lock icon in Linear’s sidebar) use LINEAR_PRIVATE_TEAM_COMMENT_CREATED.

Configuration

string
Optional Linear team UUID. Leave unset to fire workspace-wide. Use LINEAR_LIST_LINEAR_TEAMS to discover valid team UUIDs.

Payload

object
User, app, or system actor that produced the event.
string
required
ISO 8601 event timestamp.
object
required
Typed inner payload — see trigger docstring.
string
required
Linear organization UUID.
string
required
Linear URL of the resource.
Slug: LINEAR_PUBLIC_TEAM_ISSUE_CREATEDType: webhookFires when a new issue is created in a Linear public team. For private teams (lock icon in Linear’s sidebar) use LINEAR_PRIVATE_TEAM_ISSUE_CREATED.

Configuration

string
Optional Linear team UUID. Leave unset to fire workspace-wide. Use LINEAR_LIST_LINEAR_TEAMS to discover valid team UUIDs.

Payload

object
User, app, or system actor that produced the event.
string
required
ISO 8601 event timestamp.
object
required
Typed inner payload — see trigger docstring.
string
required
Linear organization UUID.
string
required
Linear URL of the resource.
Slug: LINEAR_PUBLIC_TEAM_ISSUE_PROPERTIES_UPDATEDType: webhookFires when properties on a public-team Linear issue change (status, assignee, priority, labels, etc.). For private teams (lock icon in Linear’s sidebar) use LINEAR_PRIVATE_TEAM_ISSUE_PROPERTIES_UPDATED.

Configuration

string
Optional Linear team UUID. Leave unset to fire workspace-wide. Use LINEAR_LIST_LINEAR_TEAMS to discover valid team UUIDs.

Payload

object
User, app, or system actor that produced the event.
string
required
ISO 8601 event timestamp.
object
required
Typed inner payload — see trigger docstring.
string
required
Linear organization UUID.
string
required
Linear URL of the resource.