NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Linear

linear

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

Project ManagementTask ManagementWeb del proveedor
Acciones
21
Triggers
3
Autenticación
—
OAuth gestionado
Sí
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (21)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create linear attachmentLINEAR_CREATE_LINEAR_ATTACHMENTAcción

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

Parámetros de entrada

  • urlstringObligatorio

    URL of the attachment's content (e.g., file, webpage, online resource).

  • titlestringObligatorio

    Title for the attachment.

  • issue_idstringObligatorio

    Identifier of the existing Linear issue to which the attachment will be added.

  • subtitlestringObligatorio

    Optional subtitle or short description for the attachment.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create a commentLINEAR_CREATE_LINEAR_COMMENTAcción

Creates a new comment on a specified linear issue.

Parámetros de entrada

  • bodystringObligatorio

    Non-empty comment content, in plain text or Markdown.

  • issue_idstringObligatorio

    Identifier of the existing Linear issue for the comment.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create linear issueLINEAR_CREATE_LINEAR_ISSUEAcción

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, cycle, and due date.

Parámetros de entrada

  • titlestringObligatorio

    The title of the new issue.

  • team_idstringObligatorio

    Identifier of the team responsible for this issue.

  • cycle_idstring

    Identifier 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.

  • due_datestring

    The target completion date for the issue, formatted as 'YYYY,MM,DD,hh,mm,ss'. For example: '2024,10,27,12,58,00'.

  • estimateinteger

    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.

  • priorityinteger

    Priority of the issue. 0 indicates no priority, 1 is Urgent, 2 is High, 3 is Normal, and 4 is Low.

  • state_idstring

    Identifier of the workflow state to assign to the issue (e.g., backlog, to do, in progress, done).

  • label_idsstring[]

    A list of identifiers for labels to be added to this issue.

  • parent_idstring

    Identifier of an existing issue to set as the parent of this new issue, creating a sub-issue relationship.

  • project_idstring

    Identifier of the project to which this issue will be associated.

  • assignee_idstring

    Identifier of the user to assign to this issue.

  • descriptionstring

    A detailed description of the issue, which can include markdown formatting.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get create issue default paramsLINEAR_CREATE_LINEAR_ISSUE_DETAILSAcción

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

Parámetros de entrada

  • team_idstringObligatorio

    Identifier of the Linear team.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create a labelLINEAR_CREATE_LINEAR_LABELAcción

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

Parámetros de entrada

  • namestringObligatorio

    Name of the new label, displayed in the Linear UI.

  • colorstringObligatorio

    Hexadecimal color code (e.g., '#FF0000') for the label's appearance in the UI.

  • team_idstringObligatorio

    Identifier of the team for which this label will be created.

  • descriptionstring

    Optional detailed description for the label, providing context on its use.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete issueLINEAR_DELETE_LINEAR_ISSUEAcción

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

Parámetros de entrada

  • issue_idstringObligatorio

    Identifier of the Linear issue to be archived. This can be the issue's UUID or its human-readable shorthand ID (e.g., 'TEAM-123').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get all teamsLINEAR_GET_ALL_LINEAR_TEAMSAcción

Retrieves all teams from the linear workspace without requiring any parameters.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Download issue attachmentsLINEAR_GET_ATTACHMENTSAcción

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

Parámetros de entrada

  • issue_idstringObligatorio

    The unique identifier of the Linear issue from which the attachment will be downloaded.

  • file_namestringObligatorio

    The desired name for the downloaded file, including its extension.

  • attachment_idstringObligatorio

    The unique identifier of the specific attachment to download.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get current userLINEAR_GET_CURRENT_USERAcción

Gets the currently authenticated user's id, name, email, and other profile information. use this to identify 'me' in other linear operations that require user id filtering.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get cycles by team IDLINEAR_GET_CYCLES_BY_TEAM_IDAcción

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.

Parámetros de entrada

  • team_idstringObligatorio

    The team's unique identifier.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Linear issueLINEAR_GET_LINEAR_ISSUEAcción

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

Parámetros de entrada

  • issue_idstringObligatorio

    The unique identifier of the Linear issue.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get all cyclesLINEAR_LIST_LINEAR_CYCLESAcción

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

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Linear issuesLINEAR_LIST_LINEAR_ISSUESAcción

Lists non-archived linear issues; if project id is not specified, issues from all accessible projects are returned. can also filter by assignee id to get issues assigned to a specific user.

Parámetros de entrada

  • afterstring

    Cursor for pagination. Use the `endCursor` from the previous response's `page_info` to fetch the next set of issues.

  • firstinteger

    Number of issues to return.

  • project_idstring

    ID of the project to filter issues by. If provided, only issues belonging to this project will be returned.

  • assignee_idstring

    ID of the user to filter issues by assignee. If provided, only issues assigned to this user will be returned.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get labels by teamLINEAR_LIST_LINEAR_LABELSAcción

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

Parámetros de entrada

  • team_idstringObligatorio

    The unique identifier of the team for which to retrieve labels. This ID scopes the search to a specific team within Linear.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List linear projectsLINEAR_LIST_LINEAR_PROJECTSAcción

Retrieves all projects from the linear account.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Linear statesLINEAR_LIST_LINEAR_STATESAcción

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

Parámetros de entrada

  • team_idstringObligatorio

    Unique identifier of the team.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get teams by projectLINEAR_LIST_LINEAR_TEAMSAcción

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

Parámetros de entrada

  • project_idstringObligatorio

    The unique identifier of a project. This ID is used to filter the list of projects associated with each retrieved team. If a team is not associated with this project ID, its 'projects' list in the response will be empty.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Linear usersLINEAR_LIST_LINEAR_USERSAcción

Lists all users in the linear workspace with their ids, names, emails, and active status.

Parámetros de entrada

  • afterstring

    Cursor for pagination. Use the `endCursor` from the previous response's `page_info` to fetch the next set of users.

  • firstinteger

    Number of users to return.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Remove label from Linear issueLINEAR_REMOVE_ISSUE_LABELAcción

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

Parámetros de entrada

  • issue_idstringObligatorio

    Identifier of the Linear issue from which to remove the label.

  • label_idstringObligatorio

    Identifier of the label to remove. The operation is successful without change if this label isn't on the issue.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Run Query or MutationLINEAR_RUN_QUERY_OR_MUTATIONAcción

Wildcard action that executes any graphql query or mutation against the linear api. use this as a fallback when no specific action exists for your use case, or when you need to perform complex operations not covered by other linear actions. supports full graphql capabilities including custom queries, mutations, and advanced filtering.

Parámetros de entrada

  • variablesobjectObligatorio

    Variables for the GraphQL operation. Keys must match variable names defined in the query/mutation (without the '$' prefix). Use empty dict {} if no variables are needed. All variables must have values matching the expected GraphQL types (String, Int, Boolean, etc.).

  • query_or_mutationstringObligatorio

    A valid GraphQL query or mutation string. Use this for any Linear operation not covered by specific actions. Common use cases: get current user info, complex filtering, custom data retrieval, advanced mutations.

Parámetros de salida

  • dataobjectObligatorio

    The 'data' field from the GraphQL JSON response, containing the results of the executed query or mutation. If the operation fails at the GraphQL level (e.g., validation error), this field might be absent or accompanied by an 'errors' field in the raw response, which would be handled by an exception.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update issueLINEAR_UPDATE_ISSUEAcción

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.

Parámetros de entrada

  • titlestring

    New title for the issue.

  • team_idstring

    Identifier of the team to associate with the issue.

  • due_datestring

    New due date in 'YYYY,MM,DD,hh,mm,ss' format (e.g., '2024,10,27,12,58,00').

  • estimateinteger

    New time estimate in minutes.

  • issue_idstringObligatorio

    Identifier of the issue to update.

  • priorityinteger

    Priority: 0 (No), 1 (Urgent), 2 (High), 3 (Normal), 4 (Low).

  • state_idstring

    Identifier of the new state (e.g., To Do, In Progress, Done).

  • label_idsstring[]

    List of label identifiers to set; replaces all existing labels. An empty list removes all labels.

  • parent_idstring

    Identifier of an existing issue to set as parent.

  • project_idstring

    Identifier of the project to associate with the issue.

  • assignee_idstring

    Identifier of the user to assign to the issue.

  • descriptionstring

    New Markdown description for the issue.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Triggers (3)

Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).

Comment Received TriggerLINEAR_COMMENT_EVENT_TRIGGERTrigger

Triggered when a comment is received.

Configuración

  • team_idstringObligatorio

    ID of the team to filter issues by

Payload del evento

  • actionstringObligatorio

    Action that triggered the webhook

  • dataobjectObligatorio

    Data of the issue

  • typestringObligatorio

    Type of the issue

  • urlstringObligatorio

    URL of the issue

Issue Created TriggerLINEAR_ISSUE_CREATED_TRIGGERTrigger

Triggered when a new issue is created.

Configuración

  • team_idstringObligatorio

    ID of the team to filter issues by

Payload del evento

  • actionstringObligatorio

    Action that triggered the webhook

  • dataobjectObligatorio

    Data of the issue

  • typestringObligatorio

    Type of the issue

  • urlstringObligatorio

    URL of the issue

Issue Updated TriggerLINEAR_ISSUE_UPDATED_TRIGGERTrigger

Triggered when an issue is updated. For example labels are changed, issue status is changed, etc.

Configuración

  • team_idstringObligatorio

    ID of the team to filter issues by

Payload del evento

  • actionstringObligatorio

    Action that triggered the webhook

  • dataobjectObligatorio

    Data of the issue

  • typestringObligatorio

    Type of the issue

  • urlstringObligatorio

    URL of the issue