add_card_assignee
ChatGPTAtribui um responsável a um card. O usuário precisa pertencer à conta autenticada e ainda não estar atribuído ao card. O responsável passa a receber notificações relacionadas ao card e suas tarefas. Use essa ferramenta quando: o usuário quer atribuir um responsável a um card. Antes de usar: consulte get_pipe (includeAssignableUsers: true) para usuários elegíveis e get_card_context (includeAssignees: true) para evitar duplicar um responsável. Efeitos colaterais: cria o vínculo CardAssignee entre o card e o usuário; o responsável passa a receber notificações relacionadas ao card e suas tarefas. Use a ferramenta search com CreateCardAssigneeInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:cards:update_all (pipes), pipes:cards:update_limited (pipes).
add_card_label
ChatGPTAssocia uma etiqueta a um card. A etiqueta precisa pertencer ao mesmo fluxo do card e o vínculo não pode existir previamente. O card precisa pertencer à conta autenticada e não estar arquivado nem somente leitura. Use essa ferramenta quando: o usuário quer associar uma etiqueta existente a um card. Antes de usar: consulte list_labels (por pipeId) para as etiquetas disponíveis e get_card_context (includeLabels: true) para as já aplicadas. Efeitos colaterais: cria o vínculo CardLabel entre o card e a etiqueta; a etiqueta passa a aparecer nas listagens e filtros do card. Use a ferramenta search com CreateCardLabelInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:cards:update_all (pipes), pipes:cards:update_limited (pipes).
add_pipe_member
ChatGPTAdiciona um ou mais usuários já existentes na conta como membros de um fluxo, atribuindo o cargo de cada um. Aceita pessoas e times: quando o e-mail corresponde a um usuário do tipo time, o time inteiro é adicionado e seus integrantes herdam o cargo. E-mails que não pertencem a nenhum usuário da conta retornam o erro 'User not found' (nenhum convite ou e-mail é enviado). O primeiro conflito (usuário já membro ou não encontrado) interrompe a operação para os subsequentes. A criação do membro e a atribuição do cargo ocorrem em uma única transação. Use essa ferramenta quando: o usuário quer adicionar um ou mais usuários (que já pertencem à conta) como membros de um fluxo, definindo o cargo de cada um. Antes de usar: consulte get_pipe (com includeMembers: true) para ver os membros atuais do fluxo e seus papéis. Efeitos colaterais: vincula ao fluxo, com o cargo informado, usuários que já pertencem à conta e dispara notificações internas (in-app) aos adicionados; não cria novos usuários nem envia e-mails ou convites externos. Use a ferramenta search com InviteUsersToPipeInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:self:manage_users (pipes).
analyze_card_attachment
ChatGPTDispara a análise por IA do conteúdo de um anexo de card: resumo estruturado (tipo do documento, idioma detectado, resumo, pontos-chave e entidades). Por padrão é fire-and-forget: retorna ao enfileirar e o resultado é lido depois. Passe waitForResult: true para aguardar até 25 segundos pela conclusão. Análises de documentos pesados passam desse tempo: se o status voltar como pending ou processing, a análise NÃO falhou — continue aguardando com get_card_attachment_analysis(analysisId, waitForResult: true), que retoma a espera sem disparar de novo. Use essa ferramenta quando: o usuário quer um resumo ou análise do conteúdo de um documento anexado a um card. Não use quando: o anexo ainda não foi enviado; você só quer ler uma análise existente (use get_card_context com includeAttachments); ou você já disparou esta análise e só precisa continuar aguardando (use get_card_attachment_analysis, que não repete o disparo). Antes de usar: use get_card_context (includeAttachments: true) para obter o campo path do anexo (a chave usada como attachmentKey) e verificar se já existe uma análise. Efeitos colaterais: enfileira (ou reaproveita) uma análise por IA do conteúdo do anexo; o resultado fica disponível em CardAttachment.analysis e via realtime. Use a ferramenta search com AnalyzeCardAttachmentInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:cards:ai_analyze (pipes).
approve_review
ChatGPTAprova uma revisão pendente. O executor precisa ser um aprovador designado (ou delegado efetivo) da revisão; quando possui pipes:admin:submit_any_review, atua sobre o aprovador pendente de menor posição mesmo sem estar atribuído, ignorando a ordem sequencial e podendo decidir sobre a própria solicitação. A revisão precisa estar em pending; quando o template exige comentário para aprovar, o comment é obrigatório. Em uso administrativo, o log de card é gravado com details.admin_override=true, preservando o actor_id do executor. Use essa ferramenta quando: o usuário quer aprovar uma solicitação de aprovação (revisão) pendente em um card como revisor. Antes de usar: consulte list_own_reviews para identificar o id da solicitação de aprovação pendente do usuário autenticado; o id informado é o da Review, não do Reviewer. Efeitos colaterais: marca o registro do revisor autenticado como aprovado, atualiza o contador de aprovações concluídas da solicitação e, quando todos os revisores concluem, finaliza a solicitação aprovando-a; gera entradas no histórico do card e dispara notificações para o solicitante e demais envolvidos. Use a ferramenta search com ApproveReviewInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento.
assign_card_automatically
ChatGPTAtribui ao card um responsável escolhido automaticamente entre os membros elegíveis. Com um modelo de atribuição, os candidatos são os membros dele e a distribuição segue o modo do modelo (revezamento ou menor carga). Sem modelo, os candidatos vêm da configuração do fluxo e a escolha é sempre por menor carga de cards abertos. Quando todos os candidatos elegíveis já são responsáveis do card, nada é alterado e o usuário escolhido volta em branco. Use essa ferramenta quando: o usuário quer que o próprio Flux escolha o responsável de um card, por revezamento ou por menor carga, em vez de indicar uma pessoa. Não use quando: o usuário já sabe quem deve ficar responsável pelo card: nesse caso use add_card_assignee. Antes de usar: a conta precisa ter a flag feature:automatic-assignment ativa (confira com get_account e includeFeatureFlags: true); com modelo, obtenha o templateId em list_templates (filtrando templateType: assignment); sem modelo, os candidatos são os de get_pipe_assignment_settings. Efeitos colaterais: cria o vínculo entre o card e o responsável escolhido, que passa a receber as notificações do card; no modo de revezamento, consome a vez do membro escolhido no modelo. Use a ferramenta search com CreateCardAssigneeViaAssignmentInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:cards:update_all (pipes), pipes:cards:update_limited (pipes).
attach_deadline_template_to_pipe
ChatGPTAtribui um prazo a um fluxo a partir de um template de prazo (templateId). Falha quando o fluxo já possui um prazo: remova o prazo atual antes de tentar novamente. O template referenciado precisa pertencer à conta autenticada e ao mesmo fluxo. Efeito colateral: cria um registro de prazo e grava pipe.deadline_id apontando para ele. Use essa ferramenta quando: o usuário quer definir o prazo padrão de um fluxo a partir de um template de prazo já existente. Antes de usar: consulte list_templates (filtrando por pipeId e templateType: deadline) para obter o id do template de prazo desejado; use get_pipe para verificar se o fluxo já possui um prazo configurado. Efeitos colaterais: cria um prazo concreto no fluxo a partir das configurações do template (duração, risco, unidades, feriados e horário comercial); o template em si não é alterado. Falha se o fluxo já tiver um prazo configurado; remova o prazo atual antes de tentar novamente. Permissões: pipes:deadlines:create_pipe (pipes).
attach_deadline_template_to_stage
ChatGPTAtribui um prazo a uma etapa a partir de um template de prazo (templateId). Falha quando a etapa já possui um prazo: remova o prazo atual antes de tentar novamente. O template referenciado precisa pertencer à conta autenticada e ao mesmo fluxo da etapa. Efeito colateral: cria um registro de prazo e grava stage.deadline_id apontando para ele. Use essa ferramenta quando: o usuário quer definir o prazo de uma etapa a partir de um template de prazo já existente. Antes de usar: consulte list_templates (filtrando por pipeId e templateType: deadline) para obter o id do template de prazo desejado e list_stages para identificar a etapa de destino; use get_stage para verificar se a etapa já possui um prazo. Efeitos colaterais: cria um prazo concreto na etapa a partir das configurações do template (duração, risco, unidades, feriados e horário comercial); o template em si não é alterado. Falha se a etapa já tiver um prazo configurado; remova o prazo atual antes de tentar novamente. Permissões: pipes:deadlines:create_stage (pipes).
attach_templates_to_stage
ChatGPTVincula um ou mais templates (prazo, tarefa ou aprovação) a uma etapa de um fluxo. Templates já vinculados não são duplicados. Não cria, altera nem arquiva os templates em si — apenas a associação com a etapa. Para ordenar tarefas e aprovações entre si, use set_stage_template_dependencies. Use essa ferramenta quando: o usuário quer vincular um ou mais templates de tarefa ou aprovação a uma etapa de um fluxo. Para templates de prazo, use attach_deadline_template_to_stage; para definir dependências entre os templates da etapa, use set_stage_template_dependencies. Antes de usar: consulte list_templates (filtrando por pipeId) para obter os ids dos templates do fluxo e list_stages para identificar a etapa de destino; use list_templates_by_stage para verificar o que já está vinculado. Efeitos colaterais: cria os vínculos entre os templates de tarefa ou aprovação informados e a etapa; templates já vinculados não são duplicados. Para templates de prazo, use attach_deadline_template_to_stage. Argumentos: stageId: Etapa de destino dos templates. Precisa pertencer à conta autenticada.; templatesIds: Templates a serem vinculados à etapa. Cada template precisa pertencer à conta autenticada e ao mesmo fluxo da etapa. Permissões: pipes:templates:update (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-modelos.md") tem o contrato completo desta ferramenta.
batch_upsert_automation_data
ChatGPTSubstitui em lote o gatilho, suas condições e a lista de ações de uma automação V2. Use essa ferramenta quando: o usuário quer configurar de uma só vez o gatilho, suas condições e a lista completa de ações de uma automação V2 (criar pela primeira vez ou substituir os existentes). Antes de usar: consulte get_automation (com includeTrigger: true e includeActions: true) para entender a configuração atual; consulte list_automation_metadata para conhecer os tipos de gatilho e ação disponíveis e o formato esperado de properties (e includeContext para variáveis de contexto). Efeitos colaterais: operação destrutiva por substituição: gatilho, condição ou ação que não for incluída no input é excluída; itens com id são atualizados e itens sem id são criados. Limite de 1 gatilho, 100 condições e 10 ações. Afeta o disparo a partir das próximas execuções, sem alterar as já registradas. Use a ferramenta search com BatchUpsertAutomationV2Input para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: global:automations_v2:manage_actions (global), global:automations_v2:manage_triggers (global), pipes:automations_v2:manage_actions (pipes), pipes:automations_v2:manage_triggers (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-automacao.md") tem o contrato completo desta ferramenta.
create_automation
ChatGPTCria uma nova automação V2 no escopo informado (conta ou fluxo). Cria apenas o registro da automação com nome, descrição e status; o gatilho e as ações precisam ser configurados em seguida via batchUpsertAutomationV2Data. Enquanto não houver um gatilho válido, a automação não dispara mesmo se o status for ativo. Use essa ferramenta quando: o usuário quer criar uma nova automação V2 na conta ou em um fluxo. Efeitos colaterais: cria apenas o registro da automação V2 (nome, descrição, status e fluxo opcional); o gatilho e as ações precisam ser configurados em seguida via batch_upsert_automation_data. Enquanto não houver um gatilho válido, a automação não dispara mesmo se o status for ativo. Use a ferramenta search com CreateAutomationV2Input para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: global:automations_v2:create (global), pipes:automations_v2:create (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-automacao.md") tem o contrato completo desta ferramenta.
create_card
ChatGPTCria um card em um fluxo, respondendo o formulário inicial na mesma chamada. As respostas vão em answers, uma lista de { questionId, value }; o campo fields está depreciado e enviar os dois na mesma requisição é recusado. Um valor fora do formato do tipo do campo recusa a criação inteira, sem criar card pela metade. Use essa ferramenta quando: o usuário quer criar um card novo em um fluxo que ele opera, com ou sem respostas do formulário inicial. Não use quando: a pessoa quer abrir um pedido para um fluxo que ela não opera, e não criar o item direto; nesse caso use create_solicitation. Antes de usar: consulte get_pipe com includeStartForm e includeStartFormQuestions para obter o id de cada pergunta do formulário inicial antes de montar answers. Efeitos colaterais: cria o card na primeira etapa do fluxo que recebe cards diretamente, ou na etapa informada, com o formulário inicial respondido; uma etapa informada que não recebe cards diretamente (canReceiveCardDirectlyFromDraft: false) recusa a criação com stage/cannot-receive-card-from-draft; aplica responsáveis e etiquetas quando informados e dispara as automações de criação de card. Use a ferramenta search com CreateCardInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:cards:create (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-card-e-solicitacao.md") e get_wiki_document(documentId: "mcp/preencher-campos.md") têm o contrato completo desta ferramenta.
create_label
ChatGPTCria uma nova etiqueta. Use essa ferramenta quando: o usuário quer criar uma nova etiqueta em um fluxo para categorizar cards. Efeitos colaterais: cria a etiqueta e a torna disponível para ser associada a cards e tarefas do fluxo informado. Use a ferramenta search com CreateLabelInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:labels:create (pipes).
create_pipe
ChatGPTCria um novo fluxo. Use essa ferramenta quando: o usuário quer criar um novo fluxo na conta. Efeitos colaterais: também cria automaticamente o formulário inicial do fluxo, três etapas padrão (A fazer, Fazendo, Concluído), os cargos padrão do fluxo, e adiciona o usuário autenticado como administrador do fluxo. Use a ferramenta search com CreatePipeInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: global:pipes:create (global). Documentação: get_wiki_document(documentId: "mcp/criar-fluxo.md") tem o contrato completo desta ferramenta.
create_solicitation
ChatGPTAbre uma solicitação em um fluxo, respondendo o formulário inicial na mesma chamada. Recebe a mesma entrada de create_card, mas o que acontece depois depende da configuração do fluxo: exigindo aprovação, a solicitação fica pendente até alguém decidir; sem exigir, o card correspondente é criado imediatamente. Use essa ferramenta quando: o usuário quer abrir um pedido para um fluxo, em vez de criar o card diretamente. Não use quando: a pessoa opera o fluxo e quer o card direto, sem passar por pedido; nesse caso use create_card. Também não use para contornar falta de permissão de criar card: a solicitação tem consequências de processo. Antes de usar: consulte get_pipe com includeStartForm e includeStartFormQuestions para obter o id de cada pergunta do formulário inicial antes de montar answers. Efeitos colaterais: abre a solicitação no fluxo. Quando o fluxo exige aprovação, ela nasce pendente e só vira card depois de aprovada; caso contrário o card é criado na hora e a solicitação já nasce aceita. Dispara as notificações do fluxo de solicitação. Use a ferramenta search com CreateCardInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Documentação: get_wiki_document(documentId: "mcp/criar-card-e-solicitacao.md") e get_wiki_document(documentId: "mcp/preencher-campos.md") têm o contrato completo desta ferramenta.
create_stage
ChatGPTCria uma nova etapa. Use essa ferramenta quando: o usuário quer adicionar uma nova etapa a um fluxo existente. Efeitos colaterais: também cria um formulário vazio vinculado à etapa e registra o conjunto inicial de respostas vazio. O índice (ordem) da etapa é definido automaticamente como o último do fluxo. Quando color é omitido, a etapa nasce com a cor "gray", a mesma que o formulário da interface envia. Use a ferramenta search com CreateStageInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:stages:create (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-fluxo.md") tem o contrato completo desta ferramenta.
create_template_assignment
ChatGPTCria um modelo de atribuição automática no fluxo informado: um subconjunto ordenado de membros do fluxo, pessoas ou times, que as automações usam para escolher quem recebe um card. Use essa ferramenta quando: o usuário quer criar um modelo de atribuição automática em um fluxo, com a lista ordenada de membros e a estratégia de distribuição (round_robin reveza na ordem informada, least_loaded escolhe quem tem menos cards abertos). Não use quando: a distribuição deve considerar os membros do fluxo inteiro em vez de um subconjunto: nesse caso não existe modelo, e quem entra no sorteio vem de update_pipe_assignment_settings. Antes de usar: a conta precisa ter a flag feature:automatic-assignment ativa (confira com get_account e includeFeatureFlags: true), e incluir um time na lista exige também feature:automatic-assignment-teams e feature:teams; consulte get_pipe (com includeMembers: true) para obter os membros do fluxo elegíveis, pois a ordem do array members é a ordem de revezamento. Efeitos colaterais: cria o modelo e o disponibiliza para as automações que atribuem responsável; nenhum card é atribuído neste momento. Use a ferramenta search com CreateTemplateAssignmentInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:create (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-modelos.md") tem o contrato completo desta ferramenta.
create_template_deadline
ChatGPTCria um novo template de prazo no fluxo informado. O template fica disponível para ser vinculado a etapas via attachTemplatesToStage e referenciado em automações; vincular o template a uma etapa é uma operação separada. Use essa ferramenta quando: o usuário quer criar um template de prazo (deadline) em um fluxo para reuso em etapas e automações. Efeitos colaterais: cria o template de prazo no fluxo informado e o disponibiliza para ser vinculado a etapas via attach_templates_to_stage e usado em automações. Use a ferramenta search com CreateTemplateDeadlineInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:create (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-modelos.md") tem o contrato completo desta ferramenta.
create_template_document
ChatGPTCria um modelo de documento no fluxo informado. A estrutura do corpo e cada expressão são validadas no servidor. Use essa ferramenta quando: o usuário quer criar um modelo de documento em um fluxo, escrevendo o corpo com variáveis do card para que uma automação gere depois o arquivo (docx, pdf ou txt). Antes de usar: a conta precisa ter a feature flag document:templates ativa (confira com get_account e includeFeatureFlags) e o fluxo precisa estar ativo; consulte list_variables para saber quais variáveis existem. O content é a árvore do editor, no formato {"type":"doc","content":[...]}: os nós aceitos são doc, paragraph, text, heading (níveis 1 a 3), bulletList, orderedList, listItem, table, tableRow, tableCell, tableHeader, hardBreak, horizontalRule, pageBreak e interpolationBlock, e as marcas aceitas são bold, italic, underline, strike, link e textStyle. As variáveis entram no meio do texto entre chaves duplas ({{card.name}}); trecho repetido ou condicional vira um nó interpolationBlock com attrs.kind igual a each ou if, attrs.expression com a expressão e attrs.alias opcional (padrão item). Nó, marca ou expressão fora dessa lista é recusado ao salvar, e o corpo aceita no máximo 1 MB. Efeitos colaterais: cria o modelo e o disponibiliza para a ação de automação que gera documento a partir de um card; nenhum arquivo é gerado agora. Use a ferramenta search com CreateTemplateDocumentInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:create (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-modelos.md") tem o contrato completo desta ferramenta.
create_template_report
ChatGPTCria um novo template de relatório no fluxo informado. O template define a estrutura de um relatório tabular gerado a partir de um card; sua execução é tratada em operações específicas. Use essa ferramenta quando: o usuário quer criar um template de relatório em um fluxo, definindo colunas e expressões para exportar dados estruturados (xlsx) dos cards. Efeitos colaterais: cria o template de relatório no fluxo informado e o disponibiliza para ser referenciado pela ação em massa pipe_export_template_report ao exportar cards. Use a ferramenta search com CreateTemplateReportInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:create (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-modelos.md") tem o contrato completo desta ferramenta.
create_template_review
ChatGPTCria um novo template de revisão (aprovação) no fluxo informado. O template fica disponível para ser vinculado a etapas via attachTemplatesToStage e referenciado em automações; vincular o template a uma etapa é uma operação separada. O modelo de prazo e a modalidade do SLA da decisão são definidos nesta operação: informe deadlineTemplateId (um modelo de prazo do mesmo fluxo, não arquivado e com duração definida) junto de deadlineMode; em aprovação paralela a modalidade é sempre a de prazo único, independentemente do valor enviado. Use essa ferramenta quando: o usuário quer criar um template de aprovação (revisão) em um fluxo, definindo revisores, regras de aprovação e o prazo da decisão. Antes de usar: consulte get_pipe (com includeAssignableUsers: true) para obter os usuários elegíveis como revisores do fluxo. Para vincular prazo, consulte list_templates com templateType deadline para obter os modelos de prazo do fluxo. Efeitos colaterais: cria o template de aprovação no fluxo informado e o disponibiliza para ser vinculado a etapas via attach_templates_to_stage e usado em automações. Use a ferramenta search com CreateTemplateReviewInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:create (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-modelos.md") e get_wiki_document(documentId: "mcp/preencher-campos.md") têm o contrato completo desta ferramenta.
create_template_task
ChatGPTCria um novo template de tarefa no fluxo informado. O template fica disponível para ser vinculado a etapas via attachTemplatesToStage e referenciado em automações; vincular o template a uma etapa é uma operação separada. Use essa ferramenta quando: o usuário quer criar um template de tarefa em um fluxo, com responsáveis, etiquetas, prioridade e prazo padrão. Efeitos colaterais: cria o template de tarefa no fluxo informado e o disponibiliza para ser vinculado a etapas via attach_templates_to_stage e usado em automações. Use a ferramenta search com CreateTemplateTaskInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:create (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-modelos.md") e get_wiki_document(documentId: "mcp/preencher-campos.md") têm o contrato completo desta ferramenta.
delete_label
ChatGPTRemove uma etiqueta. Use essa ferramenta quando: o usuário quer excluir permanentemente uma etiqueta de um fluxo. Efeitos colaterais: exclusão permanente (hard delete): remove também todas as associações da etiqueta com cards (cardLabel) e com tarefas de cards (cardTaskLabel) da conta. Não pode ser desfeita. Use a ferramenta search com DeleteLabelInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:labels:delete (pipes).
detach_template_from_stage
ChatGPTDesvincula um template de uma etapa. Remove apenas a associação entre o template e a etapa; o template continua existindo no fluxo e pode ser revinculado posteriormente via attach_templates_to_stage. Para arquivar o template em si, use set_template_archived. Use essa ferramenta quando: o usuário quer desvincular um template de uma etapa sem arquivar o template. Antes de usar: consulte list_templates_by_stage para confirmar que o template está realmente vinculado à etapa. Efeitos colaterais: remove apenas o vínculo entre o template e a etapa; o template continua existindo no fluxo e pode ser revinculado posteriormente via attach_templates_to_stage. Argumentos: stageId: Etapa da qual o template será desvinculado.; templateId: Template a ser desvinculado da etapa. Permissões: pipes:templates:update (pipes).
generate_pipe_documentation
ChatGPTGera a documentação completa de um fluxo em Markdown. Use essa ferramenta quando: o usuário precisa gerar a documentação completa de um fluxo. Não use quando: o fluxo já tem documentação escrita e a pergunta é sobre como o processo funciona — nesse caso use get_pipe_generated_documentation. Esta ferramenta monta um retrato da configuração atual na hora, não a descrição do processo. Retorna: markdown. Permissões: global:pipes:read_all (global), global:pipes:read_limited (global).
get_account
ChatGPTRetorna os dados da conta (nome, status, datas) e, opcionalmente, as funcionalidades ativas e as feature flags ativas. Use essa ferramenta quando: o usuário precisa ver informações da conta (nome, status, datas) e, opcionalmente, as funcionalidades ativas (includeFeatures) ou as feature flags ativas (includeFeatureFlags). Permissões: global:features:read_all (global), global:features:read_limited (global). Dados opcionais (@include): includeFeatures (default: false): traz as funcionalidades ativas da conta (status, datas e detalhes da funcionalidade: nome, slug, tipo e descrição); includeFeatureFlags (default: false): traz as feature flags ativas da conta (slug, estado ativo, descrição e metadados).
get_authenticated_user_role
ChatGPTRetorna o papel do usuário autenticado. Use essa ferramenta quando: o usuário quer saber qual é o seu cargo e permissões em um fluxo ou banco de dados específico. Retorna: id, name, type, isLocked, hasOperatorPermission, permissions. Dados opcionais (@include): includePermissions (default: false): traz a lista detalhada de permissões do papel (título, escopo e descrição de cada uma).
get_automation
ChatGPTBusca uma automação pelo ID. Use essa ferramenta quando: o usuário precisa ver os detalhes de uma automação específica, incluindo status, triggers e ações. Retorna: id, name, description, status, createdAt, updatedAt, createdBy, pipe, trigger, actions. Permissões: global:automations_v2:read (global), pipes:automations_v2:read (pipes). Dados opcionais (@include): includeTrigger (default: false): traz o gatilho da automação (tipo, propriedades e suas condições); includeTriggerConditions (default: true): traz as condições do gatilho (propriedade, operador, valor e se é interpolado); só tem efeito quando o gatilho é incluído; includeActions (default: false): traz as ações executadas pela automação (tipo, posição e propriedades).
get_bulk_action
ChatGPTRecupera uma ação em massa pelo ID, com seu tipo, status e contagens de sucesso/falha. Use essa ferramenta quando: o usuário quer ver o status ou detalhes de uma ação em massa específica (use includeItems para também retornar os itens individuais da ação em lote). Dados opcionais (@include): includeItems (default: false): traz a lista paginada de itens individuais da ação em massa, com índice, identificador, status e código/mensagem de erro de cada item.
get_card_attachment_analysis
ChatGPTLê uma análise por IA de anexo de card já disparada, usando o analysisId devolvido por analyze_card_attachment. Com waitForResult: true, aguarda até 25 segundos pela conclusão e devolve o resultado na própria resposta. Se o status voltar como pending ou processing, a análise NÃO falhou: ela ainda está rodando e a espera pode ser retomada chamando esta ferramenta novamente (até 3 vezes no total costuma cobrir os documentos mais pesados). Use essa ferramenta quando: você disparou uma análise com analyze_card_attachment e precisa do resultado dela, ou precisa continuar aguardando uma análise que voltou como pending ou processing. Não use quando: a análise ainda não foi disparada (use analyze_card_attachment primeiro), ou você quer ler as análises de todos os anexos de um card de uma vez (use get_card_context com includeAttachments). Retorna a análise com id, status e, quando concluída, documentType, language, summary, keyPoints e entities; quando falhou, errorCode. Argumentos: analysisId: Identificador da análise; waitForResult: Quando verdadeiro, aguarda até 25 segundos pela conclusão da análise antes de responder. Permissões: pipes:cards:ai_analyze (pipes).
get_card_context
ChatGPTRetorna a visão completa e canônica de um card pelo ID, com flags include para trazer responsáveis, etiquetas, campos, prazos, histórico, linha do tempo, logs, anexos, relação, link compartilhado, aprovações e tarefas conforme necessário. Use essa ferramenta quando: o usuário precisa de uma visão completa de um card. É a leitura canônica de um card: use as flags include (includeAssignees, includeLabels, includeFields, includeInitialFormFields, includeHistory, includeHistoryFields, includeTimeline, includeLogs, includeAttachments, includeRelation, includeSharedLink, includeReviewAggregate, includeDeadlines, includeHistoryInStage, includeTasks, includeTaskFields, includeReviewerFields) para trazer apenas o que precisar. Sempre que usar includeTasks, includeRelation ou includeSharedLink, informe também cardIdStr com o mesmo valor de cardId, pois esses dados são consultados por cardIdStr (string) e não pelo cardId; se cardIdStr não for informado, ele assume string vazia e essas consultas não retornam nada. As respostas de formulário do card ficam em cinco lugares, cada um com seu flag: etapa atual (includeFields), formulário inicial preenchido na criação (includeInitialFormFields), etapas já visitadas (includeHistory + includeHistoryFields), tarefas e aprovações. Para correlacionar o card com as respostas de formulário das suas tarefas, use includeTasks + includeTaskFields; para as respostas das aprovações, use includeReviewAggregate + includeReviewerFields. Não use quando: o usuário quer os detalhes de uma única tarefa de card; nesse caso use get_card_task. Dados opcionais (@include): includeAssignees (default: true): Traz os responsáveis atuais do card (id, nome, e-mail); includeLabels (default: true): Traz as etiquetas aplicadas ao card (id, nome, cor); includeFields (default: true): Traz os campos de formulário da etapa atual do card, com valores preenchidos e metadados; includeFieldOptions (default: false): Adiciona as opções disponíveis de cada campo de seleção da etapa atual (id, valor, posição); includeInitialFormFields (default: false): Traz as respostas do formulário inicial do card, preenchido na criação, com o id que update_card_field aceita e a indicação de campo travado após a criação; includeReview (default: false): Traz a última aprovação do card de forma resumida (status, tipo e datas); includeCounts (default: true): Traz os totalizadores do card: contagem de tarefas (total e concluídas) e de comentários; includeDeadlines (default: false): Traz os prazos do card: prazo do fluxo, prazo da etapa atual e prazos por etapa, com status e datas; includeHistory (default: false): Traz o histórico de etapas pelas quais o card passou, com a etapa (stageId), a duração e a indicação da etapa atual; includeHistoryFields (default: false): Adiciona, em cada etapa do histórico, os campos preenchidos naquela etapa. Exige includeHistory; includeTimeline (default: false): Traz a linha do tempo cronológica do card, consolidando resumo, entradas de etapa e eventos; includeTimelineSummary (default: true): Adiciona o resumo da linha do tempo (duração total, total de transições, etapa atual, arquivamento e criação); includeTimelineStageEntries (default: true): Adiciona as entradas de etapa da linha do tempo (etapa, duração, chegada e saída do card); includeTimelineEvents (default: false): Adiciona os eventos individuais da linha do tempo (tipo, autor, motivo e etapas de origem/destino); includeHistoryInStage (default: false): Traz o histórico do card em uma etapa específica (informada via stageId, o mesmo do histórico), com os campos preenchidos naquela etapa; includeLogs (default: false): Traz os logs de auditoria do card (eventos com autor, motivo, valores antigos e novos e detalhes); includeAttachments (default: false): Traz a lista paginada de anexos do card, com origem por etapa, tarefa ou revisor; includeRelation (default: false): Traz a relação do card (card relacionado e sua etapa atual, conforme a permissão de acesso); includeSharedLink (default: false): Traz o link compartilhado de formulário do card, com configurações d…
get_card_task
ChatGPTBusca os detalhes de uma única tarefa de card pelo ID, incluindo título, descrição, status, prioridade, prazo e quem a criou. Use essa ferramenta quando: o usuário precisa ver os detalhes de uma tarefa específica de um card; use includeFields para os campos do formulário, includeAssignees para os responsáveis, includeLabels para as etiquetas e includeSharedLink para o link público de compartilhamento da tarefa. Não use quando: o usuário quer a visão completa/canônica de um card (e não de uma única tarefa); nesse caso use get_card_context. Permissões: pipes:cards:read_task (pipes). Dados opcionais (@include): includeStage (default: true): traz a etapa (stage) à qual a tarefa pertence; includeFields (default: false): traz os campos do formulário da tarefa com seus valores e metadados; includeAssignees (default: false): traz os responsáveis atribuídos à tarefa; includeLabels (default: false): traz as etiquetas associadas à tarefa; includeSharedLink (default: false): traz o link público de compartilhamento do formulário da tarefa e suas configurações.
get_database
ChatGPTObtém os detalhes de um banco de dados específico por ID, com schema, membros e logs de auditoria opcionais. Use essa ferramenta quando: o usuário precisa ver os detalhes de um banco de dados específico (use includeSchema para os campos e estrutura, includeMembers para os membros e includeLogs para os logs de auditoria; membros e logs exigem passar membersFilters/logsFilters com o databaseId). Permissões: global:database:read_all (global), global:database:read_limited (global), databases:self:manage_users (databases), databases:audit_logs:read_database (databases), databases:audit_logs:read_record (databases). Dados opcionais (@include): includeSchema (default: false): Traz o schema do banco de dados com a estrutura dos campos (nome, tipo, obrigatoriedade, posição, chave primária e unicidade); includeMembers (default: false): Traz a lista paginada de membros do banco de dados com o tipo de papel e o usuário associado; includeLogs (default: false): Traz os logs de auditoria paginados do banco de dados (ação, motivo, detalhes, autor e registro afetado).
get_database_record
ChatGPTObter um registro específico do banco de dados pelo ID. Use essa ferramenta quando: o usuário precisa ver os detalhes de um registro específico de um banco de dados. Retorna: id, data, createdAt, updatedAt, createdBy, updatedBy. Permissões: databases:records:read (databases).
get_error
ChatGPTRetorna os metadados de um erro do Flux a partir do seu código exato. Use essa ferramenta quando: o usuário fornece o código exato de um erro (ex.: card/not-found) e precisa dos metadados completos: mensagem ao usuário, explicação técnica, categoria, caminho da documentação e documentos de apoio. Não use quando: para descobrir o código de um erro a partir de uma descrição ou sintoma, use search_errors; esta ferramenta exige o código exato. Retorna: code, message, explanation, docPath, category, supportingDocs. Argumentos: code: Código exato do erro a ser consultado (ex.: card/not-found).
get_field
ChatGPTBusca um campo pelo ID. Use essa ferramenta quando: o usuário precisa ver os detalhes de um campo específico, como tipo, valor, opções e validações. Retorna: id, type, title, value, required, position, answeredAt, helpText, options, schema, customValidation, customValidationMessage. Permissões: pipes:cards:read_all (pipes), pipes:cards:read_limited (pipes). Dados opcionais (@include): includeOptions (default: false): traz a lista de opções de escolha do campo (id, valor e posição), usada em campos de seleção como select, radio e checkbox.
get_form
ChatGPTBusca um formulário pelo ID, retornando seus metadados básicos (nome, tipo, contagem de questões) e, opcionalmente, suas questões e os usuários e times com acesso. Use essa ferramenta quando: o usuário precisa ver os detalhes de um formulário específico, incluindo suas questões e quem tem acesso (use includeUserAccess para os usuários e includeTeamAccess para os times com acesso, dobrando essas leituras nesta mesma chamada). Dados opcionais (@include): includeQuestions (default: false): Traz as questões do formulário (título, tipo, obrigatoriedade, posição e texto de ajuda); includeOptions (default: false): Traz as opções de cada questão (valor, posição, descrição e pontuação); requer includeQuestions; includeUserAccess (default: false): Traz os usuários com acesso ao formulário (nome, e-mail e avatar); includeTeamAccess (default: false): Traz os times com acesso ao formulário (nome, descrição e slug).
get_labels_by_ids
ChatGPTRetorna etiquetas por IDs. Use essa ferramenta quando: o usuário precisa buscar uma ou mais etiquetas por id em um fluxo (informe pipeId; retorna uma lista). Retorna: id, name, color, createdAt. Permissões: pipes:labels:read (pipes).
get_me
ChatGPTRetorna os dados do usuário autenticado. Use essa ferramenta quando: o usuário quer saber seus próprios dados, como nome, email, avatar ou provedor de login. Para o cargo ou as permissões do usuário autenticado, use get_authenticated_user_role. Não use quando: o usuário precisa do cargo (role) ou das permissões do usuário autenticado; nesse caso use get_authenticated_user_role. Retorna: name, email, avatarUrl, loginProvider.
get_notification
ChatGPTBusca uma notificação pelo ID. Use essa ferramenta quando: o usuário precisa ver os detalhes de uma notificação específica. Retorna: id, type, readAt, favoritedAt, tags, createdAt, updatedAt, notificationData.
get_pipe
ChatGPTBusca um fluxo pelo ID e retorna seus detalhes, podendo incluir etapas, etiquetas, prazo, membros e formulário inicial conforme os flags. Use essa ferramenta quando: o usuário precisa de uma visão do fluxo (detalhes, etapas, etiquetas, prazo e/ou membros). Use includeMembers para a lista paginada/buscável de membros e includeAssignableUsers para usuários atribuíveis. Permissões: global:pipes:read_all (global), global:pipes:read_limited (global), pipes:self:read_users (pipes). Dados opcionais (@include): includeStages (default: true): traz as etapas do fluxo, com tipo, ordem e configurações de revisão e de movimentação de cards; includeLabels (default: true): traz as etiquetas disponíveis no fluxo (id, nome e cor); includeDeadline (default: false): traz a configuração de prazo do fluxo, incluindo limites, risco, horário comercial e tratamento de feriados; includeMembers (default: false): traz a lista paginada/buscável de membros do fluxo (pipesMembers), com papéis, usuários e type (user ou team); includeStartForm (default: false): traz o formulário inicial do fluxo (id, nome, tipo e contagem de perguntas); includeStartFormQuestions (default: false): traz as perguntas do formulário inicial, com título, tipo, obrigatoriedade, posição e schema; includeOptions (default: false): traz as opções de cada pergunta (valor, posição, descrição e pontuação); includeAssignableUsers (default: false): traz os usuários atribuíveis no fluxo, para uso em filtros de responsável.
get_pipe_assignment_settings
ChatGPTLê a configuração da distribuição automática sem modelo do fluxo: quais membros entram no sorteio, se times são candidatos e quem está excluído. Um fluxo que nunca configurou nada responde com os padrões (todos os membros, sem exclusões). Use essa ferramenta quando: o usuário quer saber quem entra na distribuição automática de responsáveis de um fluxo quando a automação não aponta para um modelo de atribuição. A configuração é do fluxo: vale para todas as automações dele que distribuem sem modelo. Não use quando: o usuário quer os candidatos de um modelo de atribuição específico: esses membros vêm de get_template (com includeAssignmentDetails: true). Retorna: pipeId, memberScope, includeTeams e excludedUserIds. Os excluídos vêm como ids, resolvíveis com get_users_by_ids. Argumentos: pipeId: ID do fluxo cuja configuração de atribuição será lida. Permissões: pipes:self:read_users (pipes).
get_pipe_generated_documentation
ChatGPTLê a documentação que a Iara já escreveu para um fluxo, na versão mais recente. Use essa ferramenta quando: o usuário pergunta como um processo funciona e o fluxo já tem documentação escrita. É a descrição autoritativa do processo: prefira-a a inferir o funcionamento pela configuração do fluxo. Não use quando: o que se precisa é o retrato da configuração atual do fluxo (etapas, campos, automações) e não a descrição do processo — nesse caso use generate_pipe_documentation. Retorna a versão mais recente, em qualquer status: id, status, origem, o Markdown da documentação, idioma e quando foi gerada. Vem null se o fluxo nunca foi documentado, e o Markdown só está preenchido quando o status é completed. Permissões: global:pipes:read_all (global), global:pipes:read_limited (global).
get_pipe_solicitation
ChatGPTRecupera o fluxo de solicitação pelo ID. Use essa ferramenta quando: o usuário precisa ver os detalhes de um fluxo de solicitação pelo ID da solicitação. Retorna: id, name, description, color, icon, cardsCount, private, createdAt.
get_review
ChatGPTBusca uma aprovação pelo ID. Use essa ferramenta quando: o usuário precisa ver os detalhes de uma aprovação específica; use includeReviewers para os revisores e includeReviewerFields para as respostas de formulário (campos) de cada revisor. Retorna: deadline, id, status, type, orientationMessage, completedReviewsCount, createdAt, lastReviewedAt, requestedBy, card, stage, reviewers. Dados opcionais (@include): includeDeadline (default: false): Traz o prazo (SLA) da decisão: situação, início, risco, vencimento projetado, conclusão e, quando pausada, desde quando e quanto tempo já foi pausado ao todo. Combine com includeReviewers para obter o prazo individual de cada aprovador na modalidade por aprovador; includeCard (default: true): Identifica o card ao qual a aprovação pertence (id e nome); includeStage (default: true): Identifica a etapa em que a aprovação está (id e nome); includeReviewers (default: false): Traz os revisores da aprovação com status, comentário, data da revisão e usuário responsável; includeReviewerFields (default: false): Traz as respostas de formulário (campos preenchidos) de cada revisor; depende de includeReviewers.
get_role
ChatGPTBusca um papel pelo ID, retornando seus detalhes (nome, descrição, tipo, bloqueio e permissão de operador). Use essa ferramenta quando: o usuário precisa ver os detalhes e permissões de um papel específico, podendo opcionalmente incluir os usuários do papel (includeUsers), as permissões (includePermissions) ou os usuários atribuíveis ao papel (includeAssignableUsers). Permissões: databases:roles:read (databases), global:roles:read (global), pipes:roles:read (pipes). Dados opcionais (@include): includeUsers (default: false): traz a lista paginada de usuários que possuem o papel; includePermissions (default: false): traz as permissões associadas ao papel; includeAssignableUsers (default: false): traz os usuários que podem ser atribuídos ao papel.
get_solicitation_detail
ChatGPTRecupera os detalhes de uma solicitação pelo ID. Use essa ferramenta quando: o usuário precisa ver os detalhes (metadados) de uma solicitação, como nome, etapa atual, fluxo, responsáveis, prazo e status (bloqueado/somente leitura). Não retorna os valores dos campos do formulário do card. Retorna: id, name, locked, readonly, canAnswerInitialForm, createdAt, createdBy, currentStage, pipe, assignees, commentCount, pipeDeadline, initialFormResponsible.
get_stage
ChatGPTBusca uma etapa pelo ID. Use essa ferramenta quando: o usuário precisa de uma visão da etapa (detalhes, campos do formulário, prazo e contagem de cards). Retorna: id, name, description, color, index, type, canReceiveCardDirectlyFromDraft, reviewRequired, reviewType, moveCardToNextStageWhenDone, createdAt, cardsCount, pipe, fields, form, deadline. Permissões: pipes:stages:read (pipes). Dados opcionais (@include): includeFields (default: true): traz os campos do formulário da etapa (tipo, título, obrigatoriedade, posição e texto de ajuda); includeForm (default: false): traz o formulário associado à etapa (nome, tipo e quantidade de perguntas); includeDeadline (default: false): traz a configuração de prazo da etapa (tempo limite, risco, horário comercial e consideração de feriados).
get_team
ChatGPTRecupera uma equipe pelo ID. Use essa ferramenta quando: o usuário precisa ver os detalhes de uma equipe específica. Retorna: id, name, description, slug, createdAt, updatedAt. Permissões: global:teams:read_all (global), global:teams:read_limited (global).
get_template
ChatGPTBusca um template pelo id. Use essa ferramenta quando: o usuário precisa ver os detalhes de qualquer tipo de template (prazo, tarefa, aprovação, relatório, documento ou atribuição automática). Retorna campos específicos de cada tipo. Retorna: id, name, description, type, archived, pipeId, createdAt, updatedAt, fields. Permissões: pipes:templates:read (pipes). Dados opcionais (@include): includeFields (default: false): traz os campos do template (e as colunas, no caso de template de relatório) com nome, tipo, obrigatoriedade e posição; includeReviewDetails (default: false): traz os revisores configurados no template de aprovação, com usuário e posição; includeTaskDetails (default: false): traz os responsáveis e as etiquetas resolvidos do template de tarefa; includeAssignmentDetails (default: false): traz os membros do modelo de atribuição automática, com usuário, tipo (user ou team) e posição na ordem de revezamento. assignmentMembersTake já vem com 100, o teto de membros do modelo, para trazer a lista inteira de uma vez: reduza apenas se quiser paginar de propósito, e compare items com totalCount antes de reescrever a lista em update_template_assignment; includeDocumentContent (default: false): traz o corpo do modelo de documento (a árvore do editor de texto rico). É um objeto grande, de até 1 MB: peça só quando precisar ler ou reescrever o corpo.
get_template_usage
ChatGPTLista etapas e automações v2 que utilizam o template informado. Usado para exibir impacto antes de arquivar o template. Use essa ferramenta quando: o usuário precisa saber quais etapas e automações utilizam um template específico. Retorna: stages, automationsV2. Permissões: pipes:templates:read (pipes).
get_users_by_ids
ChatGPTRetorna uma lista de usuários pelos IDs. Use essa ferramenta quando: o usuário precisa buscar um ou mais usuários por id (retorna sempre uma lista, mesmo para um único id). Retorna: id, name, email, avatarUrl, createdAt, lastSeenAt, licenseType, roleType, type, isAbsent.
get_wiki_document
ChatGPTRetorna o conteúdo Markdown completo de um documento da documentação do Flux. Use essa ferramenta quando: o usuário precisa do conteúdo completo de um documento específico da documentação, identificado pelo id (caminho) retornado por search_wiki_documents. Não use quando: para descobrir qual documento ler a partir de uma dúvida ou texto, use search_wiki_documents; esta ferramenta exige o identificador exato retornado pela busca. Retorna: id, title, url, content.
list_automation_executions
ChatGPTRecupera uma lista paginada de execuções de automações. Use essa ferramenta quando: o usuário quer ver o histórico de execuções de uma automação, incluindo o status de cada execução (por exemplo, se concluiu ou falhou). Retorna resultados paginados com: id, status, triggerType. Suporta paginação (skip/take), filtros (PaginatedAutomationV2ExecutionFilters), ordenação. Permissões: global:automations_v2:read_executions (global), pipes:automations_v2:read_executions (pipes). Dados opcionais (@include): includeTimestamps (default: false): traz os horários de início e término de cada execução (startedAt, completedAt); includeResultData (default: false): traz os dados de resultado produzidos por cada execução (resultData).
list_automation_metadata
ChatGPTLista os metadados disponíveis para configurar automações V2, incluindo tipos de gatilho, ação e variáveis de contexto. Use essa ferramenta quando: o usuário precisa conhecer os tipos de gatilho, ação e/ou variáveis de contexto disponíveis ao configurar uma automação V2 (use includeTriggers, includeActions, includeContext para escolher o que retornar). Dados opcionais (@include): includeTriggers (default: true): traz os tipos de gatilho disponíveis (rótulo, descrição e propriedades configuráveis); includeTriggerConditions (default: false): traz as condições configuráveis de cada gatilho (propriedade, tipo, operadores e valores permitidos); includeActions (default: true): traz os tipos de ação disponíveis (rótulo, descrição e propriedades configuráveis); includeContext (default: false): traz as variáveis de contexto disponíveis nas automações (caminho, categoria, tipo, rótulo e descrição). Documentação: get_wiki_document(documentId: "mcp/criar-automacao.md") tem o contrato completo desta ferramenta.
list_automations
ChatGPTRecupera uma lista paginada de automações. Use essa ferramenta quando: o usuário quer listar todas as automações de um fluxo ou da conta. Retorna resultados paginados com: id, name, status, createdAt. Suporta paginação (skip/take), filtros (PaginatedAutomationV2Filters), ordenação. Permissões: global:automations_v2:read (global), pipes:automations_v2:read (pipes). Dados opcionais (@include): includeDescription (default: false): Traz a descrição da automação; includeTimestamps (default: false): Traz a data de última atualização (updatedAt) da automação; includePipe (default: false): Traz o fluxo ao qual a automação pertence (id e nome); includeCreatedBy (default: false): Traz o usuário que criou a automação (id e nome).
list_bulk_actions
ChatGPTRecupera uma lista paginada de ações em massa. Use essa ferramenta quando: o usuário quer listar as ações em massa realizadas na conta. Retorna resultados paginados com: id, type, status, entityId. Suporta paginação (skip/take), filtros (PaginatedBulkActionFilters), ordenação. Dados opcionais (@include): includeCounts (default: false): traz os contadores de cada ação em massa (total de itens, sucessos e falhas); includeCreatedAt (default: false): traz a data de criação de cada ação em massa.
list_card_stage_tasks
ChatGPTRetorna tarefas por etapa do card. Use essa ferramenta quando: o usuário quer ver as tarefas de uma etapa específica de um card. Não use quando: se precisar das tarefas filtradas por card (use list_cards_tasks) ou de todas as tarefas de um fluxo inteiro (use list_cards_tasks_by_pipe). Retorna resultados paginados com: id, title, status, priority. Argumentos: cardId: ID do card; cardStageEntryId: ID da etapa do card; hasFormSubmitted: Se o formulário foi submetido. Dados opcionais (@include): includeDates (default: false): traz as datas da tarefa (prazo, criação e última atualização); includeCard (default: false): traz o card ao qual a tarefa pertence (e o fluxo correspondente); includeFields (default: false): traz os campos do formulário da tarefa com seus valores respondidos.
list_cards
ChatGPTRetorna uma lista paginada de cards de um fluxo. Use essa ferramenta quando: o usuário precisa listar os cards de um fluxo específico, com possibilidade de filtrar e ordenar. Em fluxos com muitos cards, prefira filtros a páginas grandes e mantenha take <= 25 (páginas grandes deixam a consulta lenta). Não use quando: para listar apenas os cards em que o usuário autenticado é responsável, use list_self_cards; para listar cards ainda não abertos/visualizados, use list_unopened_cards. Retorna resultados paginados com: id, name, archived. Suporta paginação (skip/take), filtros (FiltersCardsInput), ordenação. Dados opcionais (@include): includeCurrentStage (default: false): traz a etapa atual de cada card (identificação e nome da etapa em que o card está); includeCreatedBy (default: false): traz o usuário que criou cada card; includeLabels (default: false): traz as etiquetas associadas a cada card (nome e cor); includeCounts (default: false): traz as contagens agregadas de cada card: tarefas (total e concluídas) e comentários (total).
list_cards_tasks
ChatGPTRetorna uma lista paginada de tarefas de cards. Use essa ferramenta quando: o usuário quer listar todas as tarefas de cards, com possibilidade de filtrar por status, prioridade, prazo (vencimento), card, etapas ou fluxo. Não use quando: para tarefas de uma etapa específica use list_card_stage_tasks; para tarefas de um fluxo inteiro use list_cards_tasks_by_pipe. Retorna resultados paginados com: id, title, status, priority. Suporta paginação (skip/take), filtros (CardTaskWhereInputDto), ordenação. Dados opcionais (@include): includeDates (default: false): traz as datas da tarefa (prazo, conclusão e criação); includeCard (default: false): traz o card ao qual a tarefa pertence e o fluxo correspondente; includeFields (default: false): traz os campos da tarefa com chave, nome, tipo, valor(es) e data de resposta.
list_cards_tasks_by_pipe
ChatGPTRetorna tarefas de cards por fluxo. Use essa ferramenta quando: o usuário quer listar as tarefas de cards filtradas por um fluxo específico. Não use quando: as tarefas devem ser filtradas por card (use list_cards_tasks) ou pertencem a uma etapa específica (use list_card_stage_tasks). Retorna resultados paginados com: id, title, status, priority. Suporta paginação (skip/take), filtros (CardTaskByPipeWhereInputDto), ordenação. Dados opcionais (@include): includeDates (default: false): traz as datas da tarefa (prazo, conclusão e criação); includeCard (default: false): traz o card ao qual a tarefa pertence e o fluxo associado; includeFields (default: false): traz os campos preenchidos da tarefa com seus valores.
list_database_records
ChatGPTObter todos os registros de um banco de dados específico. Use essa ferramenta quando: o usuário quer listar os registros de um banco de dados, com possibilidade de filtrar e ordenar. Retorna resultados paginados com: id, createdAt, updatedAt. Suporta paginação (skip/take), filtros (PaginatedDatabaseRecordFilters), ordenação. Permissões: databases:records:read (databases). Dados opcionais (@include): includeData (default: false): traz os valores dos campos de cada registro (o conteúdo dos dados, além de id e datas).
list_databases
ChatGPTObter uma lista paginada de bancos de dados. Use essa ferramenta quando: o usuário quer listar todos os bancos de dados disponíveis na conta. Retorna resultados paginados com: id, name, description. Suporta paginação (skip/take), filtros (PaginatedDatabasesFilters), ordenação. Permissões: global:database:read_all (global), global:database:read_limited (global).
list_forms
ChatGPTRetorna uma lista paginada de formulários. Use essa ferramenta quando: o usuário quer listar todos os formulários disponíveis. Retorna: nodes. Suporta filtros (FiltersFormInput).
list_labels
ChatGPTRetorna uma lista paginada de etiquetas. Use essa ferramenta quando: o usuário quer listar as etiquetas disponíveis em um fluxo (informe o fluxo em filters.pipeId). Retorna resultados paginados com: id, name, color. Suporta paginação (skip/take), filtros (PaginatedLabelsFilters), ordenação. Permissões: pipes:labels:read (pipes). Dados opcionais (@include): includeDates (default: false): traz a data de criação (createdAt) de cada etiqueta.
list_my_delegations
ChatGPTRetorna as ausências do usuário autenticado (como ausente ou substituto). Use essa ferramenta quando: o usuário quer ver suas próprias delegações de responsabilidade ativas. Retorna resultados paginados com: id, scope, reason, starts_at, ends_at, activatedByDelegate, delegator, delegate. Suporta paginação (skip/take), filtros (PaginatedDelegationFilters), ordenação. Permissões: global:delegations:delegate_own (global), global:delegations:manage_organization_delegations (global).
list_notification_preferences
ChatGPTRetorna as preferências de notificação do usuário autenticado. Na primeira consulta, quando ainda não existem preferências, cria e persiste um registro padrão antes de retorná-lo. Use essa ferramenta quando: o usuário quer ver suas preferências de notificação configuradas. Retorna: id, createdAt, preferences.
list_notifications
ChatGPTRetorna uma lista paginada de notificações. Use essa ferramenta quando: o usuário quer ver suas notificações recentes. Retorna resultados paginados com: id, type, readAt, favoritedAt, tags, createdAt, notificationData. Suporta paginação (skip/take), filtros (NotificationWhereInput).
list_organization_delegations
ChatGPTRetorna todas as ausências da organização (requer permissão administrativa). Use essa ferramenta quando: o usuário quer ver todas as delegações de responsabilidade da organização. Retorna resultados paginados com: id, scope, reason, starts_at, ends_at, activatedByDelegate, delegator, delegate. Suporta paginação (skip/take), filtros (PaginatedDelegationFilters), ordenação. Permissões: global:delegations:manage_organization_delegations (global).
list_own_reviews
ChatGPTRetorna as aprovações do usuário autenticado. Use essa ferramenta quando: o usuário quer ver suas próprias aprovações pendentes ou realizadas. Use o filtro deadlineSituation para restringir por situação do prazo (outOfSchedule, atRisk, paused, onSchedule, completedOutOfSchedule ou completedOnSchedule): havendo relógio aberto, a aprovação reflete o pior entre os abertos; com todos fechados, o pior entre os fechados, então uma aprovação em andamento nunca aparece como concluída. Ordene por deadline para trazer as aprovações mais urgentes primeiro. Retorna resultados paginados com: id, status, type, cardId, requestedById. Suporta paginação (skip/take), filtros (PaginatedReviewFilters), ordenação. Dados opcionais (@include): includeDeadline (default: false): Traz o prazo (SLA) da aprovação: aqui vêm apenas a situação e o vencimento projetado. O prazo individual de cada aprovador é obtido em get_review com includeReviewers; includeDates (default: false): Adiciona as datas de criação e da última revisão de cada aprovação (createdAt, lastReviewedAt); includeCard (default: false): Adiciona o card associado à aprovação (id, nome e o fluxo ao qual pertence); includeStage (default: false): Adiciona a etapa associada à aprovação (id e nome).
list_permissions
ChatGPTRetorna todas as permissões do sistema. Use essa ferramenta quando: o usuário quer ver todas as permissões do sistema. Retorna: id, title, description, scope, isOperator. Suporta filtros (PermissionsWhere).
list_pipes
ChatGPTRetorna uma lista paginada de fluxos. Use essa ferramenta quando: o usuário quer listar todos os fluxos disponíveis na conta. Retorna resultados paginados com: id, name, private, deletedAt. Suporta paginação (skip/take), filtros (PaginatedPipeFilters), ordenação. Permissões: global:pipes:read_all (global), global:pipes:read_limited (global). Dados opcionais (@include): includeDetails (default: false): traz os detalhes descritivos e visuais de cada fluxo (descrição, cor, ícone e data de criação); includeCounts (default: false): traz a quantidade de cards de cada fluxo (cardsCount).
list_reviews_by_pipe
ChatGPTRetorna as aprovações de um fluxo. Use essa ferramenta quando: o usuário quer ver todas as aprovações de um fluxo específico. Use o filtro deadlineSituation para restringir por situação do prazo (outOfSchedule, atRisk, paused, onSchedule, completedOutOfSchedule ou completedOnSchedule): havendo relógio aberto, a aprovação reflete o pior entre os abertos; com todos fechados, o pior entre os fechados, então uma aprovação em andamento nunca aparece como concluída. Ordene por deadline para trazer as aprovações mais urgentes primeiro. Retorna resultados paginados com: id, status, type, cardId, requestedById. Suporta paginação (skip/take), filtros (PaginatedReviewFilters), ordenação. Dados opcionais (@include): includeDeadline (default: false): Traz o prazo (SLA) da aprovação: aqui vêm apenas a situação e o vencimento projetado. O prazo individual de cada aprovador é obtido em get_review com includeReviewers; includeDates (default: false): traz as datas de criação e da última revisão de cada aprovação; includeCard (default: false): traz o card associado a cada aprovação (id, nome e fluxo); includeStage (default: false): traz a etapa associada a cada aprovação (id e nome).
list_roles
ChatGPTRetorna uma lista paginada de papéis. Use essa ferramenta quando: o usuário quer listar todos os cargos disponíveis na conta. Retorna resultados paginados com: id, name, description, type, isLocked, hasOperatorPermission. Suporta paginação (skip/take), filtros (RolesWhereInput). Permissões: databases:roles:read (databases), global:roles:read (global), pipes:roles:read (pipes).
list_self_cards
ChatGPTRetorna os cards do usuário autenticado. Use essa ferramenta quando: o usuário quer listar os próprios cards (criados por ele ou atribuídos a ele). Use os filtros (isSolicitation, createdByIds, assigneesIds, etc.) para refinar. Não use quando: for listar todos os cards de um fluxo (use list_cards) ou apenas os cards ainda não abertos/visualizados (use list_unopened_cards). Retorna resultados paginados com: id, name, archived. Suporta paginação (skip/take), filtros (FiltersSelfCardsInput), ordenação. Dados opcionais (@include): includeCurrentStage (default: false): traz a etapa atual do card (id e nome); includeCreatedBy (default: false): traz o autor do card (id e nome); includeLabels (default: false): traz as etiquetas do card (id, nome e cor); includeCounts (default: false): traz as contagens de tarefas (total e concluídas) e de comentários (total) do card.
list_service_accounts
ChatGPTLista as contas de serviço. Use essa ferramenta quando: o usuário quer listar as contas de serviço da conta. Retorna resultados paginados com: id, createdAt, expiresAt, deletedAt, user. Suporta paginação (skip/take), filtros (PaginatedServiceAccountFilters), ordenação. Permissões: global:service_accounts:read (global).
list_solicitation_forms
ChatGPTRetorna formulários de solicitação paginados. Use essa ferramenta quando: o usuário quer listar os formulários de solicitação disponíveis para submissão. Retorna resultados paginados com: id, name, type. Suporta paginação (skip/take), filtros (WhereSolicitationFormsInput). Dados opcionais (@include): includePipe (default: false): traz o fluxo (pipe) ao qual cada formulário de solicitação pertence.
list_stages
ChatGPTRetorna as etapas de um fluxo. Use essa ferramenta quando: o usuário quer listar todas as etapas de um fluxo. Retorna: id, name, index, type, description, color, canReceiveCardDirectlyFromDraft, reviewRequired, reviewType, moveCardToNextStageWhenDone, createdAt, cardsCount. Permissões: pipes:stages:read (pipes). Dados opcionais (@include): includeDetails (default: false): traz a configuração detalhada de cada etapa (descrição, cor, recebimento de card direto do rascunho, exigência e tipo de revisão, mover card para a próxima etapa ao concluir e data de criação); includeCounts (default: false): traz a quantidade de cards em cada etapa.
list_team_members
ChatGPTRecupera uma lista paginada de membros de uma equipe. Use essa ferramenta quando: o usuário quer ver quais membros fazem parte de uma equipe. Retorna resultados paginados com: id, createdAt, user. Suporta paginação (skip/take), filtros (PaginatedTeamMemberFilters), ordenação. Permissões: global:teams:read_all (global), global:teams:read_limited (global), pipes:self:manage_users (pipes).
list_teams
ChatGPTRecupera uma lista paginada de equipes. Use essa ferramenta quando: o usuário quer listar todas as equipes da conta. Retorna resultados paginados com: id, name, description, slug, createdAt, updatedAt. Suporta paginação (skip/take), filtros (PaginatedTeamFilters), ordenação. Permissões: global:teams:read_all (global), global:teams:read_limited (global), pipes:self:manage_users (pipes).
list_templates
ChatGPTBusca todos os templates. Use essa ferramenta quando: o usuário quer listar templates de um fluxo (de qualquer tipo). Filtre por templateType (deadline, report, review, task, document, assignment) para um tipo específico; use includeTypeDetails para campos específicos de cada tipo e includeFields para os campos do template. Retorna resultados paginados com: id, name, description, type, archived, pipeId, createdAt. Suporta paginação (skip/take), filtros (PaginatedTemplatesFilters), ordenação. Permissões: pipes:templates:read (pipes). Dados opcionais (@include): includeFields (default: false): traz os campos do template (id, nome, tipo, obrigatoriedade e posição) e, para templates de relatório, as colunas configuradas; includeTypeDetails (default: false): traz os campos específicos do tipo de cada template: configuração de prazo (deadline), regras de aprovação (review), atribuições/prioridade/status (task) e formato de saída do modelo de documento (document). Modelos de atribuição não têm detalhes aqui: o modo de distribuição vem do get_template. O corpo do modelo de documento nunca vem na listagem: use get_template com includeDocumentContent.
list_templates_by_stage
ChatGPTRetorna os templates vinculados a uma etapa. Use essa ferramenta quando: o usuário quer ver os templates associados a uma etapa específica. Retorna: nodes, pageInfo. Argumentos: pipeId: Fluxo ao qual a etapa pertence. Precisa pertencer à conta autenticada.; stageId: Etapa cujos templates serão listados. Precisa pertencer à conta autenticada.; after: Cursor para paginação. Identificador do item após o qual a listagem deve seguir.
list_unopened_cards
ChatGPTRetorna os cards não abertos de uma etapa. Use essa ferramenta quando: o usuário quer ver os cards que ainda não foram abertos em uma etapa específica. Em fluxos com muitos cards, prefira filtros a páginas grandes e mantenha take <= 25 (páginas grandes deixam a consulta lenta). Não use quando: para a lista geral de cards de um fluxo use list_cards; para apenas os cards em que o usuário autenticado é responsável use list_self_cards. Retorna resultados paginados com: id, name. Argumentos: stageId: The stage ID. Suporta paginação (skip/take), ordenação. Permissões: pipes:cards:read_all (pipes), pipes:cards:read_limited (pipes). Dados opcionais (@include): includeCurrentStage (default: false): traz a etapa atual do card (id e nome); includeLabels (default: false): traz as etiquetas associadas ao card (id, nome e cor).
list_user_invites
ChatGPTObtém uma lista de convites de usuário. Use essa ferramenta quando: o usuário quer ver os convites de usuário pendentes na conta. Retorna resultados paginados com: id, email, status, createdAt, acceptedAt, createdBy. Suporta paginação (skip/take), filtros (UserInviteWhereInput). Permissões: global:general:add_remove_users (global).
list_users
ChatGPTRetorna uma lista paginada de usuários. Use essa ferramenta quando: o usuário quer listar todos os usuários da conta. Retorna resultados paginados com: id, name, email, avatarUrl, licenseType, roleType, type, isAbsent. Suporta paginação (skip/take), filtros (GetUsersWhereInput).
list_variables
ChatGPTLista variáveis customizadas com paginação e filtros. Suporta variáveis customizadas de conta e de fluxo. Use essa ferramenta quando: o usuário quer ver/listar as variáveis customizadas configuradas (de conta e/ou de fluxo), opcionalmente filtrando por chave, escopo (ACCOUNT ou PIPE), secret ou pipeId. Retorna resultados paginados com: id, key, description, scope, secret, pipeId, createdAt. Suporta paginação (skip/take), filtros (PaginatedCustomVariablesFilters), ordenação. Permissões: global:variables:read (global), pipes:variables:read (pipes).
move_card_to_stage
ChatGPTMove um card de uma etapa para outra dentro do mesmo fluxo, gerando histórico e disparando automações de movimentação. A etapa de origem precisa coincidir com a etapa atual do card; a de destino precisa pertencer ao mesmo fluxo. Ao avançar, valida tarefas e campos obrigatórios da etapa atual. Use essa ferramenta quando: o usuário quer mover um card de uma etapa para outra dentro do mesmo fluxo. Antes de usar: consulte get_card_context para ver a etapa atual do card antes de movê-lo. Efeitos colaterais: o card sai da etapa atual e entra na etapa de destino, gerando registros de histórico e potencialmente disparando automações associadas à movimentação; pode validar tarefas obrigatórias e campos obrigatórios da etapa atual antes de permitir a movimentação. Use a ferramenta search com MoveCardToStageInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:cards:move (pipes).
move_stage_axis_x
ChatGPTMove uma etapa no eixo horizontal. Use essa ferramenta quando: o usuário quer reposicionar uma etapa específica no eixo horizontal do fluxo, definindo a etapa anterior ou próxima. Antes de usar: consulte list_stages para identificar os ids das etapas vizinhas e definir corretamente a posição alvo. Efeitos colaterais: recalcula e atualiza o índice (ordem) da etapa movida e potencialmente das etapas vizinhas afetadas. Use a ferramenta search com MoveStageAxisInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:stages:update (pipes).
order_stages
ChatGPTReordena etapas com base na lista de IDs fornecida. Use essa ferramenta quando: o usuário quer reordenar todas as etapas de um fluxo passando a lista completa de IDs na ordem desejada. Antes de usar: consulte list_stages para obter a lista completa de ids das etapas do fluxo na ordem atual antes de montar a nova ordem. Efeitos colaterais: atualiza o índice (ordem) de todas as etapas do fluxo conforme a lista de IDs fornecida; precisa receber a lista completa das etapas do fluxo. Use a ferramenta search com OrderStagesInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:stages:update (pipes).
reject_review
ChatGPTRejeita uma revisão pendente. O executor precisa ser um aprovador designado (ou delegado efetivo); quando possui pipes:admin:submit_any_review, atua sobre o aprovador pendente de menor posição mesmo sem estar atribuído, ignorando a ordem sequencial e podendo decidir sobre a própria solicitação. A revisão precisa estar em pending e o comment é sempre obrigatório. Em uso administrativo, o log de card é gravado com details.admin_override=true, preservando o actor_id do executor. Use essa ferramenta quando: o usuário quer recusar (reprovar) uma solicitação de aprovação (revisão) pendente em um card como revisor, registrando o motivo da recusa. Antes de usar: consulte list_own_reviews para identificar o id da solicitação de aprovação pendente do usuário autenticado; o id informado é o da Review, não do Reviewer; o campo comment é obrigatório (até 3000 caracteres) e deve descrever o motivo da recusa. Efeitos colaterais: marca o registro do revisor autenticado como recusado e finaliza a solicitação como rejeitada; o card pode ficar bloqueado para movimentação conforme a configuração da etapa, gera entradas no histórico e dispara notificações para o solicitante e demais envolvidos. Use a ferramenta search com RejectReviewInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento.
remove_card_assignee
ChatGPTRemove um responsável existente de um card. O usuário precisa pertencer à conta autenticada e estar atualmente atribuído ao card. O usuário deixa de receber notificações relacionadas ao card. Use essa ferramenta quando: o usuário quer remover um usuário da lista de responsáveis de um card. Antes de usar: consulte get_card_context (includeAssignees: true) para ver os responsáveis atuais. Efeitos colaterais: remove o vínculo CardAssignee entre o card e o usuário; o usuário deixa de receber notificações relacionadas ao card. Use a ferramenta search com RemoveCardAssigneeInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:cards:update_all (pipes), pipes:cards:update_limited (pipes).
remove_card_label
ChatGPTRemove apenas o vínculo entre uma etiqueta e um card; a etiqueta permanece disponível no fluxo. O card precisa pertencer à conta autenticada e não estar arquivado nem somente leitura. Use essa ferramenta quando: o usuário quer desassociar uma etiqueta de um card sem excluir a etiqueta do fluxo. Antes de usar: consulte get_card_context (includeLabels: true) para ver as etiquetas aplicadas ao card. Efeitos colaterais: remove apenas o vínculo CardLabel entre o card e a etiqueta; a etiqueta continua existindo no fluxo e pode ser readicionada via add_card_label. Use a ferramenta search com RemoveCardLabelInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:cards:update_all (pipes), pipes:cards:update_limited (pipes).
remove_pipe_member
ChatGPTRemove um ou mais membros de um fluxo. Usuários referenciados em ações de automação ativas (ex.: assignee_person) não podem ser removidos. A hierarquia de cargos é respeitada: o autenticado não pode remover um membro com cargo igual ou superior ao seu. Atribuições do usuário em cards do fluxo e seus papéis no fluxo são removidos. Use essa ferramenta quando: o usuário quer remover um ou mais membros de um fluxo. Antes de usar: consulte get_pipe (com includeMembers: true) para identificar os membros a remover. Efeitos colaterais: remove o vínculo dos usuários informados com o fluxo; eles perdem o acesso ao fluxo e deixam de receber notificações relacionadas a ele; cards e atribuições existentes podem ficar sem responsável associado. Use a ferramenta search com RemoveMemberFromPipeInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:self:manage_users (pipes).
request_change_review
ChatGPTSolicita alterações em uma revisão pendente, devolvendo o card ao solicitante. O executor precisa ser um aprovador designado (ou delegado efetivo); quando possui pipes:admin:submit_any_review, atua sobre o aprovador pendente de menor posição mesmo sem estar atribuído, ignorando a ordem sequencial e podendo decidir sobre a própria solicitação. A revisão precisa estar em pending e o comment é sempre obrigatório. Em uso administrativo, o log de card é gravado com details.admin_override=true, preservando o actor_id do executor. Use essa ferramenta quando: o usuário quer solicitar alterações em uma solicitação de aprovação (revisão) pendente em um card como revisor, registrando o que precisa ser ajustado antes de aprovar. Antes de usar: consulte list_own_reviews para identificar o id da solicitação de aprovação pendente do usuário autenticado; o id informado é o da Review, não do Reviewer; o campo comment é obrigatório (até 3000 caracteres) e deve descrever as alterações solicitadas. Efeitos colaterais: marca o registro do revisor autenticado como solicitação de alteração e mantém a solicitação aberta aguardando ajustes do solicitante; o comentário fica registrado no histórico do card e dispara notificações para o solicitante e demais envolvidos. Use a ferramenta search com RequestChangeReviewInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento.
search
ChatGPTPesquisa tipos e campos do schema GraphQL a partir de termos de busca, retornando as informações de tipo (incluindo tipos-pai) necessárias para montar operações. Use antes de escrever ou validar uma operação para descobrir a forma dos dados.
search_errors
ChatGPTBusca erros do Flux por texto (busca aproximada), ordenados por relevância. Use essa ferramenta quando: o usuário descreve um erro, sintoma ou trecho de mensagem e precisa descobrir o(s) código(s) de erro correspondente(s). Retorna uma lista enxuta (código, mensagem, categoria e caminho da documentação); use get_error com o código para obter os detalhes completos. Não use quando: quando já se tem o código exato do erro, use get_error para obter os metadados completos (incluindo a explicação técnica e os documentos de apoio). Retorna: code, message, docPath, category. Argumentos: query: Texto para busca aproximada de erros (mínimo de 2 caracteres).; limit: Número máximo de resultados retornados (entre 1 e 50; padrão 20).
search_wiki_documents
ChatGPTBusca documentos da documentação do Flux por texto, ordenados por relevância. A busca é restrita à documentação de produto; passe corpus: mcp para buscar, em vez dela, os guias de contrato das próprias ferramentas do Flux, que ficam fora de qualquer busca que não os peça. Use essa ferramenta quando: o usuário tem uma dúvida sobre uso do produto, telas, configurações ou procedimentos e precisa encontrar páginas relevantes da documentação; ou você precisa entender o contrato de uma ferramenta do Flux e para isso passa corpus: mcp. Retorna identificador, título, URL e um trecho de cada documento; use get_wiki_document com o identificador para ler o conteúdo completo. Não use quando: quando já se tem o identificador de um documento e se deseja o conteúdo completo, use get_wiki_document. Retorna: id, title, url, excerpt. Argumentos: query: Texto a ser buscado na documentação do Flux.; limit: Número máximo de documentos retornados (entre 1 e 25; padrão 10).; corpus: Conjunto de documentos em que buscar. O padrão "product" devolve a documentação do Flux; "mcp" devolve os guias de ferramenta endereçados a agentes, que ficam fora de qualquer busca que não os peça.
set_card_archived
ChatGPTArquiva (soft delete) ou restaura um card de acordo com o flag archived. Use essa ferramenta quando: o usuário quer arquivar um card (archived: true) ou restaurá-lo (archived: false). Efeitos colaterais: quando archived é true, arquiva (soft delete) o card; quando false, restaura o card arquivado. Permissões: pipes:cards:delete_all (pipes), pipes:cards:delete_own (pipes). Dados opcionais (@include): archived (default: false): executa o arquivamento do card (mutation archiveCard) e retorna id, name e archived; quando false, executa o desarquivamento (unarchiveCard).
set_card_locked
ChatGPTBloqueia ou desbloqueia um card para edição, conforme o valor de locked. Use essa ferramenta quando: o usuário quer bloquear um card (locked: true) ou desbloqueá-lo (locked: false). Efeitos colaterais: quando locked é true, bloqueia o card impedindo alterações; quando false, desbloqueia o card. Permissões: pipes:cards:lock_unlock (pipes). Dados opcionais (@include): locked (default: false): quando true, executa o bloqueio do card (lockCard) e retorna seu estado bloqueado; quando false, executa o desbloqueio (unlockCard) e retorna o estado liberado.
set_pipe_archived
ChatGPTArquiva (exclusão lógica) ou restaura um fluxo, conforme o valor de archived. Use essa ferramenta quando: o usuário quer arquivar um fluxo (archived: true) ou restaurá-lo (archived: false). Efeitos colaterais: quando archived é true, executa exclusão lógica do fluxo (soft delete); quando false, restaura o fluxo arquivado. Permissões: pipes:self:delete (pipes). Dados opcionais (@include): archived (default: false): quando true, arquiva o fluxo (deletePipe); quando false, restaura o fluxo arquivado (undeletePipe).
set_stage_archived
ChatGPTArquiva (soft delete) ou restaura uma etapa de um fluxo conforme o valor de archived. Use essa ferramenta quando: o usuário quer arquivar uma etapa (archived: true) ou restaurá-la (archived: false). Efeitos colaterais: quando archived é true, remove (soft delete) a etapa do fluxo; quando false, restaura a etapa arquivada. Permissões: pipes:stages:delete (pipes), pipes:stages:update (pipes). Dados opcionais (@include): archived (default: false): quando true, executa o arquivamento (soft delete) da etapa; quando false, executa a restauração da etapa arquivada.
set_stage_template_dependencies
ChatGPTDefine o conjunto completo de dependências entre os templates de uma etapa. Cada aresta liga um template pré-requisito a um template dependente, e ambos podem ser de tarefa ou de aprovação. Substitui todas as dependências existentes da etapa. Use essa ferramenta quando: o usuário quer definir, alterar ou remover a ordem de dependência entre tarefas e aprovações de uma etapa — por exemplo, exigir que uma aprovação seja concluída antes de uma tarefa ficar disponível. Antes de usar: use list_templates_by_stage para obter os ids dos templates já vinculados à etapa; apenas templates de tarefa ou aprovação já vinculados podem participar das dependências. Efeitos colaterais: substitui todas as dependências entre templates da etapa pelo conjunto informado; as dependências que não estiverem na lista são removidas. Enviar uma lista vazia remove todas. Ciclos e profundidade acima de 10 níveis são recusados. Use a ferramenta search com StageTemplateDependencyEdgeInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Argumentos: stageId: Etapa cujas dependências entre templates serão substituídas.; edges: Conjunto completo de dependências da etapa. Substitui todas as dependências existentes; enviar uma lista vazia remove todas. Permissões: pipes:stages:update (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-modelos.md") tem o contrato completo desta ferramenta.
set_template_archived
ChatGPTArquiva (soft delete) ou restaura um template, alternando seu estado de arquivado conforme o valor de archived. Use essa ferramenta quando: o usuário quer arquivar (soft delete) um template quando archived for true, ou restaurar um template arquivado quando archived for false. Antes de usar: ao arquivar (archived: true), consulte get_template_usage para saber quais etapas e automações utilizam o template antes de arquivá-lo. Efeitos colaterais: quando archived é true, executa exclusão lógica (soft delete) marcando o template como archived: ele some das listagens padrão e deixa de ser usado em novas execuções; quando archived é false, limpa o estado de arquivado e o template volta a aparecer nas listagens e pode ser vinculado a etapas e usado em automações novamente. Permissões: pipes:templates:archive (pipes). Dados opcionais (@include): archived (default: false): quando true, arquiva o template e retorna o template arquivado; quando false, restaura o template e retorna o template desarquivado (id, name, type, archived, pipeId, updatedAt). Documentação: get_wiki_document(documentId: "mcp/criar-modelos.md") tem o contrato completo desta ferramenta.
update_automation
ChatGPTAtualiza os metadados (nome e descrição) de uma automação V2 existente. Não altera gatilho, condições, ações nem status; para isso use batchUpsertAutomationV2Data ou updateAutomationV2Status. Use essa ferramenta quando: o usuário quer renomear ou alterar a descrição de uma automação V2 existente. Antes de usar: consulte get_automation para obter os valores atuais da automação e montar o input apenas com os campos que devem mudar. Efeitos colaterais: atualiza apenas os metadados (nome e descrição) da automação; gatilhos, condições e ações não são afetados. Use a ferramenta search com UpdateAutomationV2Input para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: global:automations_v2:update (global), pipes:automations_v2:update (pipes).
update_automation_status
ChatGPTAtualiza o status de uma automação V2 existente. Ao ativar, a automação passa a disparar conforme seu gatilho (precisa ter um gatilho e ações configurados); ao desativar, deixa de disparar até nova ativação; ao arquivar, é considerada removida da operação corrente. Não altera gatilho, condições nem ações. Use essa ferramenta quando: o usuário quer ativar, desativar ou arquivar uma automação V2 existente. Efeitos colaterais: ao ativar, a automação passa a disparar conforme seu gatilho; ao desativar, deixa de disparar até nova ativação; ao arquivar, é considerada removida da operação corrente. Use a ferramenta search com UpdateAutomationV2StatusInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: global:automations_v2:update (global), pipes:automations_v2:update (pipes).
update_card_description
ChatGPTAtualiza (ou limpa) a descrição de um card. O card precisa pertencer à conta autenticada e não estar arquivado, somente leitura ou bloqueado. Eventos de log diferenciam adição, alteração e remoção da descrição. Use essa ferramenta quando: o usuário quer alterar (ou limpar) a descrição textual de um card. Efeitos colaterais: substitui o campo description do card; envie newDescription como null para remover a descrição. Use a ferramenta search com UpdateCardDescriptionInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:cards:update_all (pipes), pipes:cards:update_limited (pipes).
update_card_field
ChatGPTResponde um campo do formulário de um card, de qualquer etapa. O valor é sempre texto, e o formato exigido depende do tipo do campo — número sem separador de milhar, data em AAAA-MM-DD ou DD/MM/AAAA, opção existente na lista do campo. Um valor fora do formato é recusado sem gravar nada. Use essa ferramenta quando: o usuário quer preencher ou alterar a resposta de um campo do formulário de um card. Não use quando: o campo pertence a uma tarefa do card (use update_card_task_field) ou ao formulário de um revisor numa aprovação (use update_review_field); o id não existe neste domínio e a chamada falha. Antes de usar: consulte get_card_context para obter o id do campo e o id do card a que ele pertence: em currentStageFields (includeFields) para a etapa atual, em fields (includeInitialFormFields) para o formulário inicial, ou em cardHistory (includeHistory + includeHistoryFields) para etapas já visitadas. Efeitos colaterais: substitui o valor do campo no formulário do card e registra a alteração no histórico. Valor em branco apaga a resposta; a obrigatoriedade só é cobrada quando o card avança de etapa. Documentação: get_wiki_document(documentId: "mcp/preencher-campos.md") tem o contrato completo desta ferramenta.
update_card_name
ChatGPTAltera o nome (título) de um card. O card precisa pertencer à conta autenticada e não estar arquivado, somente leitura ou bloqueado. A alteração é registrada no log de atividades. Use essa ferramenta quando: o usuário quer renomear (alterar o título de) um card. Efeitos colaterais: substitui o nome do card e registra a alteração no log de atividades. Use a ferramenta search com ChangeCardNameInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:cards:update_all (pipes), pipes:cards:update_limited (pipes).
update_card_task_field
ChatGPTResponde um campo do formulário de uma tarefa de card. Aceita value para valor único ou values para campos que admitem vários itens, como seleção múltipla, vários destinatários ou vários anexos. O formato exigido depende do tipo do campo, e um valor fora dele é recusado sem gravar nada. Use essa ferramenta quando: o usuário quer preencher ou alterar a resposta de um campo de uma tarefa de card. Não use quando: o campo pertence ao formulário do card (use update_card_field) ou ao de um revisor (use update_review_field). Também não use para concluir a tarefa nem alterar nome ou prazo dela: esta ferramenta só responde campos. Antes de usar: consulte get_card_context com includeTaskFields para obter o id do campo dentro da tarefa. Efeitos colaterais: substitui a resposta do campo na tarefa. Valor em branco apaga a resposta; a obrigatoriedade só é cobrada quando a tarefa é concluída. Documentação: get_wiki_document(documentId: "mcp/preencher-campos.md") tem o contrato completo desta ferramenta.
update_card_task_status
ChatGPTConclui (completed) ou reabre (reopened) uma tarefa de card. Para concluir, os campos obrigatórios da tarefa precisam estar respondidos, a tarefa não pode estar bloqueada (etapa posterior à atual do card, tarefa pai ou pré-requisito pendente, alteração de campo aguardando aprovação) e, se requiredCommentToFinish for verdadeiro, comment é obrigatório. Para reabrir, o executor precisa ser responsável pela tarefa ou, conforme a configuração de reabertura do fluxo, pelo card; pipes:admin:update_any_task ignora essas restrições e registra a ação como administrativa. Use essa ferramenta quando: o usuário quer marcar uma tarefa de card como concluída ou reabrir uma tarefa já concluída. Não use quando: o usuário quer responder um campo do formulário da tarefa (use update_card_task_field). Enviar o status atual da tarefa não altera nada. Antes de usar: consulte get_card_context com includeTasks (e cardIdStr igual ao cardId) ou list_card_stage_tasks para obter o id da tarefa e ver o status atual e requiredCommentToFinish. Efeitos colaterais: grava o status e a data de conclusão e salva o comment, quando informado, como comentário de resolução ou de reabertura. Reabrir reabre em cascata as tarefas concluídas que dependem desta. A mudança entra no histórico do card e pode disparar automações. Permissões: pipes:admin:update_any_task (pipes), pipes:cards:resolve_task (pipes).
update_initial_form
ChatGPTAtualiza o formulário inicial de um fluxo. Use essa ferramenta quando: o usuário quer editar o formulário inicial (de solicitação) de um fluxo, definindo as questões preenchidas ao criar um card. Antes de usar: consulte get_form para obter os ids e a estrutura atual das questões e montar o input corretamente. Efeitos colaterais: substitui o conjunto de questões do formulário inicial conforme o input. Para remover uma questão existente envie _destroy: true no item correspondente; novas questões são criadas e questões existentes são atualizadas pelo id. Use a ferramenta search com UpdateInitialFormInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:forms:update (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-fluxo.md") e get_wiki_document(documentId: "mcp/preencher-campos.md") têm o contrato completo desta ferramenta.
update_label
ChatGPTAtualiza uma etiqueta. Use essa ferramenta quando: o usuário quer editar o nome ou a cor de uma etiqueta existente. Antes de usar: consulte get_labels_by_ids (ou list_labels filtrando por pipeId) para obter os dados atuais da etiqueta antes de editá-la. Efeitos colaterais: as alterações de nome e cor refletem imediatamente em todos os cards e tarefas que já usam essa etiqueta. Use a ferramenta search com UpdateLabelInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:labels:update (pipes).
update_pipe
ChatGPTAtualiza um fluxo existente. Use essa ferramenta quando: o usuário quer alterar dados de um fluxo, como nome, cor, ícone, descrição, privacidade ou comportamentos de cards. Antes de usar: consulte get_pipe para obter os valores atuais do fluxo e montar o input apenas com os campos que devem mudar. Efeitos colaterais: ao definir startFormId, valida se o formulário pertence à mesma conta antes de associá-lo como formulário inicial. Use a ferramenta search com UpdatePipeInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:self:update (pipes).
update_pipe_assignment_settings
ChatGPTGrava a configuração da distribuição automática sem modelo do fluxo: escopo dos candidatos (all_members ou update_permission_only), se times são candidatos e a lista de membros excluídos. É por fluxo, não por automação. Use essa ferramenta quando: o usuário quer definir quem entra na distribuição automática de responsáveis de um fluxo quando a automação não aponta para um modelo de atribuição — inclusive excluir pessoas do sorteio. Envie a configuração completa: a lista de excluídos substitui a anterior. Não use quando: a distribuição deve considerar apenas um subconjunto ordenado de pessoas: isso é um modelo de atribuição, criado com create_template_assignment. Antes de usar: a conta precisa ter a flag feature:automatic-assignment ativa (confira com get_account e includeFeatureFlags: true), e includeTeams: true também exige feature:automatic-assignment-teams; consulte get_pipe_assignment_settings para os valores atuais, porque a gravação substitui a configuração inteira. Efeitos colaterais: regrava a configuração inteira da distribuição sem modelo do fluxo, criando a linha na primeira gravação; passa a valer para todas as automações do fluxo que distribuem sem modelo, sem alterar atribuições já feitas. Use a ferramenta search com UpdatePipeAssignmentSettingsInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Argumentos: input: Configuração completa a ser gravada. Permissões: pipes:self:manage_users (pipes).
update_pipe_member
ChatGPTDefine o papel (cargo) de um usuário. Por padrão altera o cargo de um membro dentro de um fluxo, mas, conforme o roleEntityContext informado, também pode atribuir cargos de escopo global ou de banco de dados. Use essa ferramenta quando: o usuário quer alterar o cargo (papel) de um membro existente em um fluxo (por exemplo, promover de pipe_reader para pipe_editor); informe roleEntityContext para atribuir cargos em escopo global ou de banco de dados. Antes de usar: consulte get_pipe (com includeMembers: true) para identificar o membro e o papel atual. Efeitos colaterais: substitui o cargo do usuário no escopo indicado (o fluxo por padrão, ou o escopo global ou de banco de dados quando roleEntityContext é informado); as permissões efetivas do usuário passam a refletir as do novo cargo. Use a ferramenta search com RoleEntityContextInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Argumentos: roleEntityContext: O contexto da entidade do papel (pipeId ou databaseId) do qual remover o papel do usuário. Permissões: databases:roles:manage_users (databases), global:roles:manage_users (global), pipes:roles:manage_users (pipes).
update_review_field
ChatGPTResponde um campo do formulário de um revisor numa aprovação, antes de aprovar ou reprovar. Aceita value para valor único ou values para campos que admitem vários itens. O formato exigido depende do tipo do campo, e um valor fora dele é recusado sem gravar nada. Use essa ferramenta quando: o usuário precisa preencher um campo exigido pelo formulário de uma aprovação antes de decidi-la. Não use quando: o campo pertence ao formulário do card (use update_card_field) ou a uma tarefa (use update_card_task_field). Também não use para decidir a aprovação: para isso existem approve_review, reject_review e request_change_review. Antes de usar: consulte get_card_context com includeReviewerFields para obter o id do campo dentro do revisor da aprovação. Efeitos colaterais: substitui a resposta do campo no formulário do revisor. Valor em branco apaga a resposta; a obrigatoriedade só é cobrada quando a aprovação é decidida. Documentação: get_wiki_document(documentId: "mcp/preencher-campos.md") tem o contrato completo desta ferramenta.
update_stage
ChatGPTAtualiza uma etapa existente. A etapa precisa pertencer à conta autenticada e não pode estar arquivada. Atualizações são parciais: campos omitidos preservam o valor atual. Quando o tipo efetivo passa a ser "Cancelado", o formulário e o prazo são desvinculados, todos os modelos de tarefa associados à etapa são removidos e os flags de revisão, recebimento direto, movimentação automática e modo de confirmação ao mover card são forçados para os valores adequados. Para limpar a lista de destinos permitidos (canMoveCardTo), envie [] de forma explícita; omitir o campo preserva a lista atual. Use essa ferramenta quando: o usuário quer editar dados de uma etapa, como nome, cor, descrição, ordem ou regras de revisão. Antes de usar: consulte get_stage para obter os valores atuais da etapa e montar o input apenas com os campos que devem mudar. Efeitos colaterais: alterações em campos como done, reviewRequired ou moveCardToNextStageWhenDone podem afetar o comportamento de cards já presentes na etapa. Use a ferramenta search com UpdateStageInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:stages:update (pipes).
update_stage_form
ChatGPTAtualiza o formulário de uma etapa. Use essa ferramenta quando: o usuário quer editar as questões do formulário de uma etapa específica do fluxo. Antes de usar: consulte get_form para obter os ids e a estrutura atual das questões e montar o input corretamente. Efeitos colaterais: substitui o conjunto de questões do formulário da etapa conforme o input. Para remover uma questão existente envie _destroy: true; novas questões são criadas e existentes são atualizadas pelo id. Use a ferramenta search com UpdateStageFormInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:forms:update (pipes). Documentação: get_wiki_document(documentId: "mcp/criar-fluxo.md") e get_wiki_document(documentId: "mcp/preencher-campos.md") têm o contrato completo desta ferramenta.
update_template_assignment
ChatGPTEdita um modelo de atribuição automática existente. Substitui integralmente a lista de membros pela lista informada, na ordem recebida, e atualiza nome, descrição e modo de distribuição. Trocar o modo não reinicia o revezamento. Use essa ferramenta quando: o usuário quer editar um modelo de atribuição automática (nome, descrição, modo de distribuição ou a lista/ordem de membros). A lista de membros é substituída integralmente pela informada. Antes de usar: a conta precisa ter a flag feature:automatic-assignment ativa (confira com get_account e includeFeatureFlags: true), e incluir um time na lista exige também feature:automatic-assignment-teams e feature:teams; consulte get_template (com includeAssignmentDetails: true) para obter os membros atuais e suas posições, porque members substitui a lista inteira. Efeitos colaterais: substitui integralmente a lista de membros do modelo pela lista informada, na ordem recebida, e regrava nome, descrição e modo de distribuição; atribuições já feitas em cards não são alteradas retroativamente. Use a ferramenta search com UpdateTemplateAssignmentInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:update (pipes).
update_template_deadline
ChatGPTEdita um template de prazo existente. As alterações se refletem nos prazos calculados a partir do template; cards já existentes podem ter o prazo recalculado conforme a nova configuração. Use essa ferramenta quando: o usuário quer editar um template de prazo (nome, descrição, valores de prazo, unidades, horário comercial ou campos). Antes de usar: consulte get_template (com includeFields: true) para obter os valores atuais do template e montar o input apenas com os campos que devem mudar. Efeitos colaterais: as alterações se refletem nos prazos calculados a partir do template; cards já criados podem ter o prazo recalculado conforme a nova configuração. Use a ferramenta search com UpdateTemplateDeadlineInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:update (pipes).
update_template_document
ChatGPTEdita um modelo de documento existente. Substitui integralmente o corpo pela árvore informada e atualiza nome, descrição e formato de saída. Use essa ferramenta quando: o usuário quer editar um modelo de documento (corpo, nome, descrição ou formato de saída). O corpo é substituído integralmente pelo informado. Antes de usar: consulte get_template com includeDocumentContent para obter o corpo atual, porque o content enviado substitui o anterior por inteiro: monte a árvore completa desejada, não só o trecho alterado. O content é a árvore do editor, no formato {"type":"doc","content":[...]}: os nós aceitos são doc, paragraph, text, heading (níveis 1 a 3), bulletList, orderedList, listItem, table, tableRow, tableCell, tableHeader, hardBreak, horizontalRule, pageBreak e interpolationBlock, e as marcas aceitas são bold, italic, underline, strike, link e textStyle. As variáveis entram no meio do texto entre chaves duplas ({{card.name}}); trecho repetido ou condicional vira um nó interpolationBlock com attrs.kind igual a each ou if, attrs.expression com a expressão e attrs.alias opcional (padrão item). Nó, marca ou expressão fora dessa lista é recusado ao salvar, e o corpo aceita no máximo 1 MB. Efeitos colaterais: substitui integralmente o corpo do modelo pela árvore informada e atualiza nome, descrição e formato de saída. As próximas execuções da automação passam a usar a nova versão; documentos já gerados não são alterados retroativamente. Use a ferramenta search com UpdateTemplateDocumentInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:update (pipes).
update_template_report
ChatGPTEdita um template de relatório existente. Substitui integralmente o conjunto de colunas pela lista informada e atualiza o nome e a descrição. Use essa ferramenta quando: o usuário quer editar um template de relatório (nome, descrição ou lista de colunas). A lista de colunas é substituída integralmente pela informada. Antes de usar: consulte get_template para obter os metadados atuais do template; a atualização substitui integralmente as colunas, então monte o input com a lista completa de colunas desejada (a ordem do array define a posição final no relatório). Efeitos colaterais: substitui integralmente as colunas do template pela lista informada; futuras exportações usarão a nova estrutura. Exportações já concluídas não são alteradas. Use a ferramenta search com UpdateTemplateReportInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:update (pipes).
update_template_review
ChatGPTEdita um template de revisão existente. As alterações se refletem nas próximas aprovações solicitadas pelo template; aprovações já abertas não são alteradas retroativamente. O modelo de prazo e a modalidade do SLA da decisão também são editados aqui: informe deadlineTemplateId (um modelo de prazo do mesmo fluxo, não arquivado e com duração definida) junto de deadlineMode para configurar ou trocar o prazo. Enviar deadlineTemplateId nulo remove o prazo e limpa a modalidade junto, mesmo que deadlineMode também seja enviado. Em aprovação paralela a modalidade é sempre a de prazo único, independentemente do valor enviado. Use essa ferramenta quando: o usuário quer editar um template de aprovação (revisores, tipo, responseType, quantidade mínima de aprovações, campos, modelo de prazo ou modalidade do prazo). Antes de usar: consulte get_template (com includeFields: true e includeReviewDetails: true) para obter os valores atuais do template e montar o input apenas com os campos que devem mudar. Para vincular prazo, consulte list_templates com templateType deadline para obter os modelos de prazo do fluxo. Efeitos colaterais: as alterações se refletem nas próximas aprovações solicitadas pelo template; aprovações já abertas não são alteradas retroativamente. Use a ferramenta search com UpdateTemplateReviewInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:update (pipes).
update_template_task
ChatGPTEdita um template de tarefa existente. As alterações se refletem nas próximas tarefas criadas a partir do template; tarefas já criadas em cards não são alteradas retroativamente. Use essa ferramenta quando: o usuário quer editar um template de tarefa (responsáveis, etiquetas, prioridade, prazo padrão ou campos). Antes de usar: consulte get_template (com includeFields: true e includeTaskDetails: true) para obter os valores atuais do template e montar o input apenas com os campos que devem mudar. Efeitos colaterais: as alterações se refletem nas próximas tarefas criadas a partir do template; tarefas já criadas não são alteradas retroativamente. Use a ferramenta search com EditTemplateTaskInput para obter a estrutura completa do(s) input(s), incluindo tipos aninhados, antes de montar o argumento. Permissões: pipes:templates:update (pipes).
validate
ChatGPTValida uma operação GraphQL contra o schema sem executá-la, confirmando sintaxe e conformidade antes da execução. Use depois de montar a operação e antes de executá-la.
