Linear

Visão geral

Linear é uma ferramenta de rastreamento de issues e planejamento de projetos criada para equipes modernas, com fluxos de trabalho ágeis, atalhos de teclado e integração com o GitHub. Com a integração Linear no SquadOS, seus agentes podem criar e atualizar issues, gerenciar projetos, listar equipes e membros, e automatizar fluxos de trabalho de desenvolvimento sem sair do chat.

Site oficial: https://linear.app/
Documentação na Composio: docs.composio.dev/toolkits/linear

Autenticação

Esta ferramenta suporta dois modos de autenticação: OAuth 2.0 (OAUTH2) e chave de API (API_KEY). O OAuth 2.0 é o método recomendado para uso pessoal; a chave de API é indicada para automações e integrações de serviço.

Você vai precisar dos seguintes campos (modo chave de API):

Campo	Obrigatório	Descrição
`api_key`	Sim	Chave de API gerada no painel do Linear em Settings → API → Personal API keys.

Para OAuth 2.0, as credenciais são gerenciadas pela Composio — não é necessário informar campos manualmente.

Como obter a credencial

OAuth 2.0

Acesse linear.app e faça login no seu workspace.
No Composio, clique em Conectar no card do Linear e siga o fluxo de autorização OAuth.
Você será redirecionado para o Linear para aprovar as permissões solicitadas (leitura, escrita, criação de issues e comentários).
Após aprovar, você volta ao SquadOS com a conta conectada.

Chave de API

Acesse linear.app e faça login.
Vá em Settings (ícone de engrenagem) → API → Personal API keys.
Clique em Create key, dê um nome descritivo (ex: “SquadOS”) e clique em Create.
Copie a chave gerada — ela só é exibida uma vez.

Como conectar no SquadOS

Acesse Ferramentas no menu lateral (/admin/tools).
Abra a aba Disponíveis e procure por Linear.
Clique no card para abrir o modal de detalhes e em Conectar.
Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso via OAuth 2.0 ou informa a chave de API obtida acima.
Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Criar anexo

LINEAR_CREATE_ATTACHMENT

Cria um novo anexo e o associa a uma issue existente no Linear.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`url`	string	Sim	URL do conteúdo do anexo (ex: arquivo, página web, recurso online).
`title`	string	Sim	Título para o anexo.
`issue_id`	string	Sim	Identificador da issue Linear à qual o anexo será adicionado. Aceita formato UUID (ex: ‘590a1127-f98b-49fc-ba74-2df8751c089e’) ou chave de issue (ex: ‘GHO-300’, ‘ENG-123’).
`subtitle`	string	Não	Subtítulo ou descrição curta opcional para o anexo.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Adicionar reação a comentário

LINEAR_CREATE_COMMENT_REACTION

Adiciona uma reação a um comentário existente no Linear. Use quando quiser reagir programaticamente a um comentário em uma issue.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`emoji`	string	Sim	Emoji para a reação. Suporta emojis Unicode ou shortcodes como ‘:thumbsup:’.
`comment_id`	string	Sim	Identificador do comentário Linear ao qual a reação será adicionada.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar comentário

LINEAR_CREATE_LINEAR_COMMENT

Cria um novo comentário em uma issue Linear especificada. Esta ação modifica dados compartilhados do workspace e não é reversível — confirme a issue-alvo e o conteúdo do comentário antes de executar.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`body`	string	Sim	Conteúdo do comentário em texto simples ou Markdown. Não pode ser somente espaços em branco.
`issueId`	string	Sim	ID da issue Linear à qual o comentário será adicionado. Aceita UUID de 36 caracteres com hífens (ex: ‘c5748ccf-c67f-4af4-bd74-fe513dc4c054’) ou identificador abreviado como ‘ENG-123’. Use a ação LINEAR_LIST_LINEAR_ISSUES para obter IDs válidos.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar issue

LINEAR_CREATE_LINEAR_ISSUE

Cria uma nova issue em um projeto e equipe especificados do Linear. Requer team_id e title, e permite propriedades opcionais como descrição, responsável, estado, prioridade, ciclo e data de entrega. Todos os parâmetros UUID (state_id, assignee_id, cycle_id, label_ids, project_id) devem pertencer à mesma equipe informada em team_id. O id da issue criada é retornado em data.id — capture-o para uso como parent_id em sub-issues ou operações de acompanhamento.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`title`	string	Sim	Título da nova issue.
`team_id`	string	Sim	UUID da equipe responsável pela issue. Use a ação LINEAR_GET_ALL_LINEAR_TEAMS para obter os UUIDs disponíveis. Não use chaves de equipe (como ‘INT’ ou ‘ENG’) nem nomes — somente UUID é aceito.
`cycle_id`	string	Não	UUID do ciclo (sprint) ao qual esta issue será atribuída. Só aplicável se o recurso de ciclos estiver habilitado para a equipe. Deve pertencer à mesma equipe de `team_id`.
`due_date`	string	Não	Data-alvo de conclusão no formato ISO8601 ou YYYY-MM-DD (ex: ‘2024-12-31’ ou ‘2024-12-31T23:59:59Z’).
`estimate`	integer	Não	Complexidade ou esforço estimado da issue em pontos (ex: 1, 2, 3, 5, 8). Aplicável somente se o recurso de estimativas estiver habilitado para a equipe.
`priority`	integer	Não	Prioridade da issue: 0 = sem prioridade, 1 = Urgente, 2 = Alta, 3 = Normal, 4 = Baixa.
`state_id`	string	Não	UUID do estado de workflow a atribuir à issue. Deve pertencer à mesma equipe de `team_id`.
`label_ids`	array	Não	Lista de UUIDs de etiquetas a adicionar. O Linear organiza etiquetas em grupos onde apenas uma por grupo pode ser aplicada. Use LINEAR_LIST_LINEAR_LABELS com `team_id` para obter etiquetas válidas.
`parent_id`	string	Não	UUID de uma issue existente para definir como pai desta, criando uma sub-issue.
`project_id`	string	Não	UUID do projeto a associar. O projeto deve pertencer à mesma equipe de `team_id`.
`assignee_id`	string	Não	UUID do usuário a atribuir à issue. O usuário deve ser membro da equipe de `team_id`.
`description`	string	Não	Descrição detalhada da issue com suporte a formatação Markdown.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar relação entre issues

LINEAR_CREATE_LINEAR_ISSUE_RELATION

Cria um relacionamento entre duas issues do Linear usando a mutation issueRelationCreate. Use para estabelecer conexões como ‘blocks’, ‘duplicate’ ou ‘related’ entre issues.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`issue_id`	string	Sim	UUID da issue primária no relacionamento.
`relation_type`	string	Sim	Tipo de relacionamento: ‘blocks’ (esta issue bloqueia a relacionada), ‘duplicate’ (esta issue é duplicata da relacionada), ‘related’ (relacionamento geral).
`related_issue_id`	string	Sim	UUID da issue relacionada.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar etiqueta

LINEAR_CREATE_LINEAR_LABEL

Cria uma nova etiqueta no Linear para uma equipe especificada, usada para categorizar e organizar issues. Nomes de etiqueta devem ser únicos dentro de cada equipe. Se uma etiqueta com o mesmo nome já existir, a existente será retornada.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`name`	string	Sim	Nome da nova etiqueta, exibido na interface do Linear. Deve ser único dentro da equipe.
`color`	string	Sim	Código de cor hexadecimal (ex: ‘#FF0000’) para a aparência da etiqueta na interface.
`team_id`	string	Sim	Identificador da equipe para a qual a etiqueta será criada.
`description`	string	Não	Descrição detalhada opcional da etiqueta, fornecendo contexto sobre seu uso.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar projeto

LINEAR_CREATE_LINEAR_PROJECT

Cria um novo projeto no Linear com nome e associações de equipe especificados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`name`	string	Sim	Nome do projeto. O Linear permite nomes duplicados dentro de uma equipe; a unicidade deve ser controlada externamente se necessário.
`team_ids`	array	Sim	Lista de IDs (UUIDs) de equipes às quais o projeto será associado. Pelo menos um ID válido é obrigatório. Use LINEAR_GET_ALL_LINEAR_TEAMS para obter os IDs.
`icon`	string	Não	Ícone opcional para o projeto. Deve ser um nome de ícone válido do conjunto do Linear (sensível a maiúsculas). Nomes válidos incluem: ‘Project’, ‘Rocket’, ‘Bug’, ‘Team’, ‘Calendar’, ‘Home’.
`color`	string	Não	Cor opcional para o projeto (código hexadecimal).
`lead_id`	string	Não	ID (UUID) opcional do usuário que liderará este projeto.
`priority`	integer	Não	Nível de prioridade: 0 = Sem prioridade, 1 = Urgente, 2 = Alta, 3 = Normal, 4 = Baixa.
`start_date`	string	Não	Data de início planejada no formato YYYY-MM-DD.
`description`	string	Não	Descrição opcional do projeto com suporte a Markdown. Máximo de 255 caracteres.
`target_date`	string	Não	Data de conclusão planejada no formato YYYY-MM-DD.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar marco de projeto

LINEAR_CREATE_PROJECT_MILESTONE

Cria um marco em um projeto do Linear com nome e data-alvo opcional. Use quando precisar adicionar marcos para acompanhar o progresso dentro de um projeto.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`name`	string	Sim	Nome/título do marco.
`project_id`	string	Sim	UUID do projeto ao qual este marco pertence.
`sort_order`	number	Não	Número de ordenação opcional. Números menores aparecem primeiro.
`description`	string	Não	Descrição opcional do marco com suporte a Markdown.
`target_date`	string	Não	Data-alvo opcional no formato YYYY-MM-DD.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar atualização de projeto

LINEAR_CREATE_PROJECT_UPDATE

Cria uma publicação de atualização de status para um projeto do Linear. Use quando precisar postar atualizações de progresso, relatórios de status ou anúncios para um projeto.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`body`	string	Sim	Conteúdo principal da atualização com suporte a Markdown. Descreve o status, progresso, bloqueios e próximos passos do projeto.
`project_id`	string	Sim	UUID único do projeto para o qual criar a atualização.
`health`	string	Não	Status de saúde do projeto: ‘onTrack’ (no prazo), ‘atRisk’ (em risco) ou ‘offTrack’ (fora do prazo).
`is_diff_hidden`	boolean	Não	Se verdadeiro, o diff (alterações desde a última atualização) não será exibido.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir issue

LINEAR_DELETE_LINEAR_ISSUE

Arquiva uma issue existente do Linear pelo seu ID, que é o modo padrão do Linear de excluir issues; a operação é idempotente. O arquivamento é permanente e não possui desfazer — confirme o identificador e o título da issue antes de executar, especialmente em operações em lote.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`issue_id`	string	Sim	ID da issue Linear a ser arquivada. Aceita UUID de 36 caracteres (ex: ‘c5748ccf-c67f-4af4-bd74-fe513dc4c054’) ou identificador abreviado (ex: ‘ENG-123’). IDs numéricos simples não são válidos.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar todas as equipes (Descontinuada)

LINEAR_GET_ALL_LINEAR_TEAMS

DESCONTINUADA: Use LinearListTeams em vez desta (retorna payloads paginados com membros e projetos); esta ferramenta retorna dados simplificados de id/nome para todas as equipes visíveis no workspace sem filtragem no servidor. Combine por ID de equipe estável, não por nome de exibição, pois os nomes não são únicos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	Cursor de paginação. Use o `endCursor` da resposta anterior em `page_info` para buscar a próxima página.
`first`	integer	Não	Número de equipes a retornar por página.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Baixar anexos de issue

LINEAR_GET_ATTACHMENT

Faz o download de um anexo específico de uma issue do Linear; o file_name deve incluir a extensão correta do arquivo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`issue_id`	string	Sim	Identificador único da issue Linear da qual o anexo será baixado.
`file_name`	string	Sim	Nome desejado para o arquivo baixado, incluindo sua extensão.
`attachment_id`	string	Sim	Identificador único do anexo específico a ser baixado.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter usuário atual

LINEAR_GET_CURRENT_USER

Obtém o ID, nome, e-mail e outras informações de perfil do usuário autenticado no momento — esta é a conta por trás do token de API, que pode ser um bot ou conta de serviço. Use o campo id retornado (aninhado em data.viewer) para operações do Linear que exijam filtragem por ID de usuário.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter ciclos por ID de equipe

LINEAR_GET_CYCLES_BY_TEAM_ID

Recupera todos os ciclos de uma equipe Linear especificada. Ciclos são períodos de trabalho com prazo definido (como sprints). Os resultados são escopados à equipe informada. Para identificar o ciclo ativo, verifique se a data atual (em UTC) está entre os campos startAt e endAt de um ciclo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`team_id`	string	Sim	Identificador único da equipe. Deve ser um UUID válido (ex: ‘d282d590-8462-4390-8ef9-98f5ac2190b0’). Use LINEAR_GET_ALL_LINEAR_TEAMS para resolver se desconhecido.
`after`	string	Não	Cursor de paginação. Use o `endCursor` da resposta anterior em `page_info`.
`first`	integer	Não	Número de ciclos a retornar por página. Máximo 250.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter parâmetros padrão de criação de issue

LINEAR_GET_ISSUE_DEFAULTS

Busca o estado e a estimativa padrão de uma equipe do Linear, útil para pré-preencher formulários de criação de novas issues.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`team_id`	string	Sim	Identificador da equipe Linear. Deve ser um UUID válido.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter issue do Linear

LINEAR_GET_LINEAR_ISSUE

Recupera os detalhes completos de uma issue existente do Linear, incluindo id, identificador, título, descrição, timestamps, estado, equipe, criador, anexos, comentários (com informações de usuário e timestamps), assinantes e data de entrega. Campos opcionais (etiquetas, projeto, estado, responsável, ciclo) podem ser nulos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`issue_id`	string	Sim	ID da issue Linear. Aceita UUID de 36 caracteres (ex: ‘c5748ccf-c67f-4af4-bd74-fe513dc4c054’) ou identificador abreviado (ex: ‘ENG-123’). IDs numéricos simples e URLs completas não são válidos.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter projeto do Linear

LINEAR_GET_LINEAR_PROJECT

Recupera um único projeto do Linear pelo seu identificador único. Use para verificar um projeto recém-criado ou atualizado, ou para buscar informações detalhadas pelo ID.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`project_id`	string	Sim	Identificador único (UUID) do projeto Linear a recuperar.
`include_teams`	boolean	Não	Se deve incluir as equipes associadas ao projeto na resposta.
`include_members`	boolean	Não	Se deve incluir os membros do projeto na resposta.
`include_initiatives`	boolean	Não	Se deve incluir as iniciativas relacionadas na resposta.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar rascunhos de issues

LINEAR_LIST_ISSUE_DRAFTS

Lista rascunhos de issues. Use quando precisar buscar issues em rascunho para revisão ou edição posterior. Verifique pageInfo.hasNextPage na resposta para determinar se existem rascunhos adicionais além da página atual.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	Cursor de paginação. Use o `endCursor` de `pageInfo` da resposta anterior.
`first`	integer	Não	Número de rascunhos de issues a retornar.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar issues por ID de equipe

LINEAR_LIST_ISSUES_BY_TEAM_ID

Lista todas as issues de uma equipe específica do Linear, escopadas pelo ID da equipe. Use quando precisar recuperar issues de uma equipe específica sem buscar issues de todo o workspace.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`team_id`	string	Sim	Identificador único (UUID) da equipe Linear cujas issues você deseja listar.
`after`	string	Não	Cursor de paginação opaco para buscar a próxima página. Deve ser o valor exato de `end_cursor` de uma resposta anterior.
`first`	integer	Não	Número de issues a retornar por página (paginação para frente). Deve estar entre 1 e 250.
`include_archived`	boolean	Não	Se deve incluir issues arquivadas nos resultados. Padrão: false (somente issues ativas).

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar todos os ciclos

LINEAR_LIST_LINEAR_CYCLES

Recupera todos os ciclos (iterações de sprint com prazo) em toda a organização da conta Linear, sem filtros aplicados. Em workspaces grandes com múltiplas equipes, isso pode gerar respostas pesadas — filtre no lado do cliente por ID de equipe e intervalo de datas usando os campos startsAt/endsAt de cada ciclo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	Cursor de paginação. Use o `endCursor` da resposta anterior em `page_info`.
`first`	integer	Não	Número de ciclos a retornar por página.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar issues do Linear

LINEAR_LIST_LINEAR_ISSUES

Lista issues não arquivadas do Linear; se project_id não for especificado, issues de todos os projetos acessíveis são retornadas. Pode filtrar por assignee_id. Somente filtros no lado do servidor project_id e assignee_id são suportados; filtros por etiqueta, estado, equipe, ciclo ou data devem ser feitos no lado do cliente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	Cursor de paginação (string opaca). Use o valor exato de `endCursor` da `page_info` da resposta anterior.
`first`	integer	Não	Número de issues a retornar. Máximo 250 por página.
`project_id`	string	Não	ID do projeto para filtrar as issues. Se fornecido, somente issues deste projeto serão retornadas.
`assignee_id`	string	Não	UUID do usuário para filtrar issues por responsável. Use ‘me’ para filtrar pelo usuário autenticado atual, ou forneça um UUID válido de usuário Linear.
`original_cursor`	string	Não	O valor do cursor original antes de ser redefinido.
`cursor_was_corrupted`	boolean	Não	Indica se o cursor de paginação foi corrompido e redefinido.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar etiquetas

LINEAR_LIST_LINEAR_LABELS

Recupera etiquetas do Linear. Se team_id for fornecido, retorna etiquetas daquela equipe específica; se omitido, retorna todas as etiquetas do workspace. Nomes de etiqueta não são únicos entre equipes — sempre use os IDs retornados, não os nomes.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	Cursor de paginação. Use o `endCursor` da `page_info` da resposta anterior.
`first`	integer	Não	Número de etiquetas a retornar por página. Máximo 250.
`team_id`	string	Não	Identificador único da equipe para a qual recuperar etiquetas. Se omitido, retorna todas as etiquetas do workspace. IDs de etiqueta no nível de workspace (retornados quando `team_id` é omitido) podem não ser válidos para mutations escopadas por equipe.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar projetos do Linear

LINEAR_LIST_LINEAR_PROJECTS

Recupera todos os projetos da conta Linear. Retorna um array simples (não uma conexão GraphQL) com os campos id e name. Sem filtragem no lado do servidor: todos os projetos do workspace são retornados independentemente da equipe ou nome — filtre no lado do cliente. Múltiplos projetos podem ter nomes idênticos; sempre confirme o project_id antes de uso em operações subsequentes.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	Cursor de paginação. Use o `endCursor` da `page_info` da resposta anterior.
`first`	integer	Não	Número de projetos a retornar por página.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar estados do Linear

LINEAR_LIST_LINEAR_STATES

Recupera todos os estados de workflow de uma equipe especificada no Linear, representando os estágios pelos quais uma issue progride no fluxo de trabalho daquela equipe. IDs de estado retornados são escopados por equipe — nunca reutilize um stateId entre equipes diferentes.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`team_id`	string	Sim	UUID de uma equipe no seu workspace Linear. Use LINEAR_GET_ALL_LINEAR_TEAMS para listar equipes e obter IDs válidos.
`after`	string	Não	Cursor de paginação. Use o `endCursor` da `page_info` da resposta anterior.
`first`	integer	Não	Número de estados a retornar por página. Máximo 250.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar equipes

LINEAR_LIST_LINEAR_TEAMS

Recupera todas as equipes com seus membros e projetos. Use IDs ou chaves de equipe estáveis (não nomes de exibição) para operações subsequentes — os nomes não são únicos. Os resultados refletem apenas as equipes visíveis para o escopo de permissão do token autenticado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	Cursor de paginação. Use o `endCursor` da `page_info` da resposta anterior.
`first`	integer	Não	Número de equipes a retornar por página. Máximo 250.
`project_id`	string	Não	ID de projeto opcional para filtrar os projetos associados de cada equipe. Se fornecido, somente projetos com este ID serão incluídos na lista de projetos de cada equipe.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar usuários do Linear

LINEAR_LIST_LINEAR_USERS

Lista todos os usuários do workspace (não escopado por equipe) com seus IDs, nomes, e-mails e status de ativo. Nomes de exibição não são únicos — use o e-mail para desambiguar antes de extrair um ID. Atribua somente usuários com active: true.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	Cursor de paginação. Use o `endCursor` da `page_info` da resposta anterior.
`first`	integer	Não	Número de usuários a retornar. Em workspaces grandes, verifique `page_info.hasNextPage` e pagine usando `after`.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Remover etiqueta de issue do Linear

LINEAR_REMOVE_ISSUE_LABEL

Remove uma etiqueta especificada de uma issue existente do Linear usando seus IDs; bem-sucedida mesmo que a etiqueta não esteja na issue. A operação é irreversível — obtenha aprovação explícita do usuário antes de executar. Use esta ação em vez de LINEAR_UPDATE_ISSUE para evitar substituir todo o conjunto de etiquetas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`issue_id`	string	Sim	Identificador da issue Linear da qual a etiqueta será removida. Verifique que esta é a issue correta antes de executar.
`label_id`	string	Sim	Identificador da etiqueta a remover. A operação é bem-sucedida sem alteração se esta etiqueta não estiver na issue.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Remover reação de comentário

LINEAR_REMOVE_REACTION

Remove uma reação de um comentário. Use quando tiver um ID de reação e precisar excluí-la.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`reaction_id`	string	Sim	Identificador da reação a excluir.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Executar query ou mutation GraphQL

LINEAR_RUN_QUERY_OR_MUTATION

Executa qualquer query ou mutation GraphQL contra a API do Linear. Use quando nenhuma ação dedicada existir, quando precisar de filtragem complexa, campos customizados ou descoberta de schema. Execute introspecção antes de operações desconhecidas. O Linear usa objetos aninhados (ex: project { id }), não IDs escalares (ex: projectId). Todos os IDs são UUIDs. Filtro: { field: { eq: value } }. Paginação: nodes[] + pageInfo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`query_or_mutation`	string	Sim	Query ou mutation GraphQL para a API do Linear. Deve ser uma string válida não vazia.
`variables`	object	Não	Variáveis para a operação GraphQL como objeto JSON. Opcional — omita ou use `{}` se não houver variáveis.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisar issues do Linear

LINEAR_SEARCH_ISSUES

Pesquisa issues do Linear usando busca de texto completo nos campos identificador, título e descrição. Use quando precisar encontrar issues por palavras-chave ou identificadores específicos. Este endpoint suporta apenas busca de texto completo; para filtragem estruturada por equipe, projeto, responsável, estado ou etiquetas, use LINEAR_LIST_ISSUES_BY_TEAM_ID.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`query`	string	Sim	Texto de pesquisa. Busca nos campos identificador da issue (ex: ‘ENG-123’), título e descrição. Somente busca de texto completo; filtragem estruturada não é suportada neste endpoint.
`after`	string	Não	Cursor de paginação. Use o `endCursor` da `page_info` da resposta anterior.
`first`	integer	Não	Número de issues a retornar por página. Deve estar entre 1 e 50. Padrão: 25.
`include_archived`	boolean	Não	Se deve incluir issues arquivadas nos resultados. Padrão: false.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar issue

LINEAR_UPDATE_ISSUE

Atualiza uma issue existente do Linear usando seu issue_id; requer ao menos um outro atributo para modificação. Todos os IDs de entidade fornecidos (para estado, responsável, etiquetas, etc.) devem ser UUIDs válidos — somente issueId aceita formato de chave (ex: ‘ENG-123’). Todos os campos atualizados são completamente sobrescritos, não mesclados; omita qualquer campo que não pretenda alterar.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`issueId`	string	Sim	Identificador da issue a atualizar. Aceita UUID (ex: ‘d282c513-3265-4513-9099-abc0123def45’) ou chave de issue (ex: ‘ENG-123’).
`title`	string	Não	Novo título para a issue.
`teamId`	string	Não	UUID da equipe para mover a issue. Use para transferir uma issue de uma equipe para outra.
`cycleId`	string	Não	UUID do ciclo (sprint) ao qual atribuir esta issue. O ciclo deve pertencer à mesma equipe da issue.
`dueDate`	string	Não	Nova data de entrega no formato ISO8601 ou YYYY-MM-DD.
`stateId`	string	Não	UUID do estado de workflow para o qual transicionar a issue. O estado deve pertencer à mesma equipe da issue.
`estimate`	integer	Não	Pontos de estimativa para a issue (ex: 1, 2, 3, 5, 8).
`labelIds`	array	Não	Lista de identificadores de etiquetas a definir; substitui todas as etiquetas existentes. Uma lista vazia remove todas as etiquetas.
`parentId`	string	Não	UUID de uma issue existente para definir como pai desta issue, tornando-a uma sub-issue.
`priority`	integer	Não	Prioridade: 0 (Nenhuma), 1 (Urgente), 2 (Alta), 3 (Normal), 4 (Baixa).
`projectId`	string	Não	UUID do projeto a associar à issue. O projeto deve pertencer à mesma equipe da issue.
`assigneeId`	string	Não	UUID do usuário a atribuir à issue. Deve ser um UUID de usuário válido do workspace Linear.
`description`	string	Não	Nova descrição em Markdown para a issue.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar comentário

LINEAR_UPDATE_LINEAR_COMMENT

Atualiza o texto do corpo de um comentário existente do Linear. Use quando precisar editar ou modificar o conteúdo de um comentário criado anteriormente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`body`	string	Sim	Novo conteúdo do comentário em texto simples ou formato Markdown.
`comment_id`	string	Sim	Identificador único do comentário a atualizar.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar projeto

LINEAR_UPDATE_LINEAR_PROJECT

Atualiza um projeto existente do Linear. Use quando precisar modificar propriedades do projeto como nome, descrição, estado, datas ou responsável. Todos os campos exceto project_id são opcionais — forneça apenas os campos que deseja atualizar.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`project_id`	string	Sim	Identificador único (UUID) do projeto a atualizar.
`icon`	string	Não	Identificador de ícone para o projeto.
`name`	string	Não	Novo nome para o projeto.
`color`	string	Não	Cor para o projeto (código hexadecimal).
`state`	string	Não	Estado do projeto. Valores padrão: ‘backlog’, ‘planned’, ‘started’, ‘completed’, ‘canceled’.
`lead_id`	string	Não	UUID do usuário que liderará este projeto. Use LINEAR_LIST_LINEAR_USERS para obter IDs válidos.
`priority`	integer	Não	Nível de prioridade: 0 = Sem prioridade, 1 = Urgente, 2 = Alta, 3 = Normal, 4 = Baixa.
`status_id`	string	Não	UUID do status do projeto a definir.
`start_date`	string	Não	Nova data de início planejada. Aceita formato YYYY-MM-DD.
`description`	string	Não	Nova descrição para o projeto em texto simples.
`target_date`	string	Não	Nova data de conclusão planejada. Aceita formato YYYY-MM-DD.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.