# Catálogo de operações MCP

Todas as operações previstas no MCP da Zild, analisadas a partir do OpenAPI, com métodos, rotas, nomes de ferramentas e contratos.

Source: https://zild.ai/pt-BR/docs/mcp-server/catalog

## Critério de publicação e escopo analisado

Este catálogo foi gerado do [OpenAPI 3.0.4, API v1](/openapi.json), incluído no site: 137 operações, 79 rotas. O MCP em execução gera suas ferramentas a partir do Swagger v1 do próprio ambiente; diferenças entre versões podem mudar o catálogo.

O adaptador percorre GET, POST, PUT, PATCH, DELETE, HEAD e OPTIONS. Este documento contém apenas GET, POST, PUT e DELETE. Não existe uma lista adicional que restrinja a publicação a consultas: cada operação do OpenAPI final gera uma ferramenta. Controllers e ações ocultos por IgnoreApi e aliases /api/ removidos pelo filtro do Swagger ficam fora desse documento.

Os nomes abaixo reproduzem a convenção do adaptador: método e rota normalizada, seguidos dos 12 primeiros caracteres do hash SHA-256 de “MÉTODO /rota”. Confirme o nome e o inputSchema com tools/list no ambiente conectado.

## Distribuição por método HTTP



<table class="api-params"><thead><tr><th>Método</th><th>Operações</th></tr></thead><tbody><tr><td>GET</td><td>51</td></tr><tr><td>POST</td><td>42</td></tr><tr><td>PUT</td><td>22</td></tr><tr><td>DELETE</td><td>22</td></tr></tbody></table>



## Áreas disponíveis



<table class="api-params"><thead><tr><th>Área</th><th>Operações</th><th>Capacidades</th></tr></thead><tbody><tr><td><a href="#area-crm">CRM</a></td><td>11</td><td>Contas e contatos: listagem, consulta por ID, contatos por conta, criação, atualização e exclusão.</td></tr><tr><td><a href="#area-agent">Agentes</a></td><td>40</td><td>Agentes, conhecimentos, skills, ferramentas, variáveis dinâmicas, coleta de dados, arquivos, links, conversas, execução e histórico com rollback.</td></tr><tr><td><a href="#area-voice">Voz</a></td><td>8</td><td>Chamadas individuais e em lote, ligação para usuário, vozes, modelos ElevenLabs e referências de ferramentas de voz.</td></tr><tr><td><a href="#area-insight">Insight</a></td><td>12</td><td>Checklists e itens, reavaliação de conversas, importação de áudio e importação do Microsoft Teams.</td></tr><tr><td><a href="#area-assist">Assist</a></td><td>8</td><td>Processamento de e-mail, conversa proativa no WhatsApp, templates e verificação de aprovação.</td></tr><tr><td><a href="#area-conversation">Conversas e mensagens</a></td><td>9</td><td>Conversas paginadas, consulta por ID, exportação, mensagens, atualização, reenvio e marcação como lida.</td></tr><tr><td><a href="#area-docs">Documentos</a></td><td>6</td><td>Documentos paginados, dashboard, consulta por ID, criação com arquivo, exclusão e reprocessamento.</td></tr><tr><td><a href="#area-flow">Flow</a></td><td>24</td><td>Fluxos e dashboard; tarefas recorrentes e ocorrências; etapas, tarefas e histórico de tarefas, conforme os métodos publicados.</td></tr><tr><td><a href="#area-agentmcpconnection">Conexões MCP de agentes</a></td><td>6</td><td>Associação de conectores a agentes, habilitação, ferramentas permitidas e descoberta de ferramentas de servidores MCP externos.</td></tr><tr><td><a href="#area-department">Departamentos e cotas</a></td><td>7</td><td>Cadastro e membros de departamentos; consulta de consumo e cotas do departamento e do tenant.</td></tr><tr><td><a href="#area-consumptiondashboard">Consumo</a></td><td>1</td><td>Consulta do dashboard de consumo por filtros; o POST não registra consumo nem altera cotas.</td></tr><tr><td><a href="#area-webhook">Webhooks</a></td><td>5</td><td>Listagem, consulta, criação e atualização de webhooks. A rota DELETE publicada atualmente não exclui o registro.</td></tr></tbody></table>



## Consultas, escrita e efeitos externos

O método HTTP não determina sozinho o efeito da ferramenta. POST /AgentHistory/filter consulta o histórico com filtros; POST /AgentHistory/rollback reverte o agente. GETs são apresentados como operações de consulta no contrato; os demais métodos devem ser avaliados pela descrição e pelo comportamento da API.

O catálogo inclui exclusões de contas, contatos, agentes, conhecimentos, skills, documentos e outros registros. Também inclui POST /Agent/run, chamadas individuais e em lote, conversa proativa no WhatsApp, processamento de e-mail, reenvio de mensagens e reprocessamento de documentos. Essas ações podem executar agentes, alterar dados, gerar consumo ou iniciar comunicações.

Não há filtragem individual do catálogo por permissão nesta versão. A API verifica a autorização durante a execução. O cliente deve avaliar os efeitos antes de chamar ferramentas de escrita e verificar o resultado antes de repetir uma chamada cujo desfecho seja incerto.

## Qualidade das descrições e cobertura

Todas as 137 operações analisadas possuem resumo e descrição. As explicações atualizadas de Flow, consumo, departamentos, conexões MCP e webhooks são aproveitadas nas ferramentas. O MCP reutiliza esses textos no título e na descrição das ferramentas; método e rota permanecem como identificação de fallback. As descrições detalhadas de cada operação estão disponíveis nas tabelas abaixo.

O CRUD herdado de Flow agora recebe descrições específicas por recurso e schemas de resposta, incluindo sucesso sem conteúdo (204) e registro não encontrado (404), quando definidos no contrato. Melhorias de texto preservam os nomes MCP porque eles dependem apenas de método e rota.

Não aparecem neste OpenAPI a listagem simples GET /Conversation, PUT /Document/{id}, rotas de UserTask ou operações de AgentModelPolicy. A execução POST /Agent/run aparece com multipart/form-data.

## Comportamentos esclarecidos no contrato atualizado

- **Flow:** PUT /FlowTask/{id} pode mover a tarefa de raia e agendar o agente responsável. Nesse caso, os demais campos enviados não são atualizados. Registrar histórico não movimenta a tarefa nem executa agentes.
- **Recorrências:** criar uma regra não gera tarefas imediatamente. A consulta de ocorrências apenas prevê as próximas datas em UTC; count tem padrão 50 e é ajustado ao intervalo de 1 a 200.
- **Consumo:** POST /ConsumptionDashboard é uma consulta com filtros, sem registrar consumo ou alterar cotas. GET /SubscriptionConsumption não está no contrato atualizado.
- **Departamentos:** a atualização substitui a lista de membros. Cota null significa ilimitada e zero bloqueia o uso. A exclusão é recusada enquanto houver agentes vinculados.
- **Conexões MCP:** gerenciam o acesso dos agentes da Zild a conectores externos. AllowedTools vazia não libera ferramentas; a descoberta consulta o servidor externo, sem executar ferramentas nem autorizar seu uso automaticamente. Estas operações são diferentes da conexão de um agente externo ao MCP Server da Zild.
- **Webhooks:** criar e atualizar configurações não envia notificação de teste. DELETE /Webhook/{id} está publicado, mas atualmente responde sem excluir ou alterar o webhook; a resposta não comprova remoção.

## CRM (11)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/get-api-Account"><code>GET /Account</code></a></td><td>Retorna todas as contas<details><summary>Descrição da API</summary><p>Este endpoint retorna todas as contas cadastradas.</p></details></td><td><code>zild_get_account_b6ca3624bad1</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Account"><code>POST /Account</code></a></td><td>Cria uma nova conta<details><summary>Descrição da API</summary><p>Este endpoint cria uma nova conta com os dados fornecidos no corpo da requisição.</p></details></td><td><code>zild_post_account_a73ca3c8d4fa</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Account-id"><code>GET /Account/{id}</code></a></td><td>Retorna uma conta por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de uma conta especificada pelo identificador.</p></details></td><td><code>zild_get_account_id_d5e47e76665c</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Account-id"><code>PUT /Account/{id}</code></a></td><td>Atualiza uma conta<details><summary>Descrição da API</summary><p>Este endpoint atualiza os dados de uma conta existente identificada pelo id.</p></details></td><td><code>zild_put_account_id_80c250b0cfd5</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Account-id"><code>DELETE /Account/{id}</code></a></td><td>Deleta uma conta<details><summary>Descrição da API</summary><p>Este endpoint deleta uma conta existente identificada pelo id.</p></details></td><td><code>zild_delete_account_id_204d8590f9b6</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Contact"><code>GET /Contact</code></a></td><td>Retorna todos os contatos<details><summary>Descrição da API</summary><p>Este endpoint retorna todos os contatos cadastrados.</p></details></td><td><code>zild_get_contact_f2bb51fbfdc0</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Contact"><code>POST /Contact</code></a></td><td>Cria um novo contato<details><summary>Descrição da API</summary><p>Este endpoint cria um novo contato com os dados fornecidos no corpo da requisição.</p></details></td><td><code>zild_post_contact_2e9539ad6c8a</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Contact-GetByAccountId-accountId"><code>GET /Contact/GetByAccountId/{accountId}</code></a></td><td>Retorna contatos por conta<details><summary>Descrição da API</summary><p>Este endpoint retorna todos os contatos vinculados a uma conta específica.</p></details></td><td><code>zild_get_contact_getbyaccountid_accountid_202dfb40f8d2</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Contact-id"><code>GET /Contact/{id}</code></a></td><td>Retorna um contato por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de um contato especificado pelo identificador.</p></details></td><td><code>zild_get_contact_id_80e630e9c3e2</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Contact-id"><code>PUT /Contact/{id}</code></a></td><td>Atualiza um contato<details><summary>Descrição da API</summary><p>Este endpoint atualiza os dados de um contato existente identificado pelo id.</p></details></td><td><code>zild_put_contact_id_3f939fb12ff8</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Contact-id"><code>DELETE /Contact/{id}</code></a></td><td>Exclui um contato<details><summary>Descrição da API</summary><p>Este endpoint exclui um contato existente identificado pelo id.</p></details></td><td><code>zild_delete_contact_id_a7fbdb2dcdd6</code></td></tr></tbody></table>



## Agentes (40)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/get-api-Agent"><code>GET /Agent</code></a></td><td>Returns all agents<details><summary>Descrição da API</summary><p>This endpoint returns all registered agents.</p></details></td><td><code>zild_get_agent_e8da87db4e1e</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Agent"><code>POST /Agent</code></a></td><td>Creates an agent<details><summary>Descrição da API</summary><p>This endpoint creates an agent.</p></details></td><td><code>zild_post_agent_76c52a0e94de</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Agent-conversation"><code>POST /Agent/conversation</code></a></td><td>Creates a new Chat conversation with the agent<details><summary>Descrição da API</summary><p>This endpoint creates a new conversation between a user and the agent.</p></details></td><td><code>zild_post_agent_conversation_741a48920bd0</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Agent-file"><code>POST /Agent/file</code></a></td><td>Attaches a file to the agent<details><summary>Descrição da API</summary><p>This endpoint adds a file to the specified agent.</p></details></td><td><code>zild_post_agent_file_a4068926a82e</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Agent-file"><code>DELETE /Agent/file</code></a></td><td>Removes a file from the agent<details><summary>Descrição da API</summary><p>This endpoint removes a file previously attached to the agent.</p></details></td><td><code>zild_delete_agent_file_ada1d1fb917c</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Agent-run"><code>POST /Agent/run</code></a></td><td>Send an user message and runs the agent<details><summary>Descrição da API</summary><p>This endpoint runs the agent with the provided input message.</p></details></td><td><code>zild_post_agent_run_7a8bef807cdd</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Agent-web-link"><code>POST /Agent/web-link</code></a></td><td>Adds web page knowledge to the agent<details><summary>Descrição da API</summary><p>This endpoint fetches the content of a web page and adds it as knowledge to the agent.</p></details></td><td><code>zild_post_agent_web_link_ac9b6b9afae1</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Agent-web-link"><code>PUT /Agent/web-link</code></a></td><td>Updates web page knowledge of the agent<details><summary>Descrição da API</summary><p>This endpoint removes the old web page content and fetches the updated content, replacing it in the agent's knowledge.</p></details></td><td><code>zild_put_agent_web_link_fd9708c20763</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Agent-id"><code>GET /Agent/{id}</code></a></td><td>Returns an agent by id<details><summary>Descrição da API</summary><p>This endpoint returns the details of an agent specified by the identifier.</p></details></td><td><code>zild_get_agent_id_28a7bbddfe13</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Agent-id"><code>PUT /Agent/{id}</code></a></td><td>Updates the agent<details><summary>Descrição da API</summary><p>This endpoint updates the agent.</p></details></td><td><code>zild_put_agent_id_c288777250f2</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Agent-id"><code>DELETE /Agent/{id}</code></a></td><td>Deletes an agent<details><summary>Descrição da API</summary><p>This endpoint deletes an existing agent identified by id, including removal of the agent from the ElevenLabs service.</p></details></td><td><code>zild_delete_agent_id_f3dd798ddd9d</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Agent-id-logo-icon"><code>POST /Agent/{id}/logo-icon</code></a></td><td>Uploads the agent logo/icon<details><summary>Descrição da API</summary><p>This endpoint uploads a logo/icon image for the specified agent.</p></details></td><td><code>zild_post_agent_id_logo_icon_21edf2bd8222</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Agent-id-logo-icon"><code>DELETE /Agent/{id}/logo-icon</code></a></td><td>Removes the agent logo/icon<details><summary>Descrição da API</summary><p>This endpoint removes the logo/icon image of the specified agent.</p></details></td><td><code>zild_delete_agent_id_logo_icon_f4bbf4622b43</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-AgentDataCollection"><code>POST /AgentDataCollection</code></a></td><td>Cria uma nova variável de coleta de dados de agente<details><summary>Descrição da API</summary><p>Este endpoint cria uma nova variável de coleta de dados de agente com os dados fornecidos.</p></details></td><td><code>zild_post_agentdatacollection_8442b85a42d5</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-AgentDataCollection-id"><code>GET /AgentDataCollection/{id}</code></a></td><td>Retorna uma variável de coleta de dados de agente por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de uma variável de coleta de dados de agente especificada pelo identificador.</p></details></td><td><code>zild_get_agentdatacollection_id_34d426026a20</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-AgentDataCollection-id"><code>PUT /AgentDataCollection/{id}</code></a></td><td>Atualiza uma variável de coleta de dados de agente<details><summary>Descrição da API</summary><p>Este endpoint atualiza os dados de uma variável de coleta de dados de agente existente identificada pelo id.</p></details></td><td><code>zild_put_agentdatacollection_id_4ca4558e2fa2</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-AgentDataCollection-id"><code>DELETE /AgentDataCollection/{id}</code></a></td><td>Remove uma variável de coleta de dados de agente<details><summary>Descrição da API</summary><p>Este endpoint remove uma variável de coleta de dados de agente existente identificada pelo id.</p></details></td><td><code>zild_delete_agentdatacollection_id_b55d01d6f756</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-AgentDynamicVariable"><code>POST /AgentDynamicVariable</code></a></td><td>Cria uma nova variável dinâmica de agente<details><summary>Descrição da API</summary><p>Este endpoint cria uma nova variável dinâmica de agente com os dados fornecidos.</p></details></td><td><code>zild_post_agentdynamicvariable_0c479b53adbb</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-AgentDynamicVariable-id"><code>GET /AgentDynamicVariable/{id}</code></a></td><td>Retorna uma variável dinâmica de agente por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de uma variável dinâmica de agente especificada pelo identificador.</p></details></td><td><code>zild_get_agentdynamicvariable_id_d0dc10777c11</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-AgentDynamicVariable-id"><code>PUT /AgentDynamicVariable/{id}</code></a></td><td>Atualiza uma variável dinâmica de agente<details><summary>Descrição da API</summary><p>Este endpoint atualiza os dados de uma variável dinâmica de agente existente identificada pelo id.</p></details></td><td><code>zild_put_agentdynamicvariable_id_378fc780072e</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-AgentDynamicVariable-id"><code>DELETE /AgentDynamicVariable/{id}</code></a></td><td>Remove uma variável dinâmica de agente<details><summary>Descrição da API</summary><p>Este endpoint remove uma variável dinâmica de agente existente identificada pelo id.</p></details></td><td><code>zild_delete_agentdynamicvariable_id_4736eff3dc1f</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-AgentHistory-agent-agentId-version-version"><code>GET /AgentHistory/agent/{agentId}/version/{version}</code></a></td><td>Retorna uma versão específica do agente<details><summary>Descrição da API</summary><p>Este endpoint retorna o estado do agente em uma versão específica.</p></details></td><td><code>zild_get_agenthistory_agent_agentid_version_version_02ff2fcb9306</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-AgentHistory-filter"><code>POST /AgentHistory/filter</code></a></td><td>Filtra o histórico de alterações com paginação<details><summary>Descrição da API</summary><p>Este endpoint permite filtrar o histórico por agente (obrigatório), usuário, tipo de ação e período. Suporta paginação.</p></details></td><td><code>zild_post_agenthistory_filter_79d1493ca742</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-AgentHistory-rollback"><code>POST /AgentHistory/rollback</code></a></td><td>Reverte o agente para uma versão anterior<details><summary>Descrição da API</summary><p>Este endpoint reverte o agente para o estado de uma versão específica.</p></details></td><td><code>zild_post_agenthistory_rollback_a43a610e7e84</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-AgentHistory-id"><code>GET /AgentHistory/{id}</code></a></td><td>Retorna um registro de histórico por ID<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de um registro de histórico específico.</p></details></td><td><code>zild_get_agenthistory_id_872a6efee8bf</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-AgentTool"><code>GET /AgentTool</code></a></td><td>Retorna todas as ferramentas de um Agente de IA<details><summary>Descrição da API</summary><p>Este endpoint retorna todas as ferramentas de um Agente de IA pelo identificador do Agente de IA.</p></details></td><td><code>zild_get_agenttool_782c31184b2e</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-AgentTool"><code>POST /AgentTool</code></a></td><td>Cria uma nova ferramenta de agente<details><summary>Descrição da API</summary><p>Este endpoint cria uma nova ferramenta de agente com os dados fornecidos.</p></details></td><td><code>zild_post_agenttool_2999969ce386</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-AgentTool-id"><code>GET /AgentTool/{id}</code></a></td><td>Retorna uma ferramenta de agente por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de uma ferramenta de agente especificada pelo identificador.</p></details></td><td><code>zild_get_agenttool_id_bf409ee13b10</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-AgentTool-id"><code>PUT /AgentTool/{id}</code></a></td><td>Atualiza uma ferramenta de agente<details><summary>Descrição da API</summary><p>Este endpoint atualiza os dados de uma ferramenta de agente existente identificada pelo id.</p></details></td><td><code>zild_put_agenttool_id_829d0f81df35</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-AgentTool-id"><code>DELETE /AgentTool/{id}</code></a></td><td>Remove uma ferramenta de agente<details><summary>Descrição da API</summary><p>Este endpoint remove uma ferramenta de agente existente identificada pelo id.</p></details></td><td><code>zild_delete_agenttool_id_c77127694d7f</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Knowledge"><code>GET /Knowledge</code></a></td><td>Retorna todos os conhecimentos de agente<details><summary>Descrição da API</summary><p>Este endpoint retorna todos os conhecimentos de agente cadastrados.</p></details></td><td><code>zild_get_knowledge_edf5231cdb00</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Knowledge"><code>POST /Knowledge</code></a></td><td>Cria um novo conhecimento de agente<details><summary>Descrição da API</summary><p>Este endpoint cria um novo conhecimento de agente com os dados fornecidos.</p></details></td><td><code>zild_post_knowledge_5157806c8d4b</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Knowledge-id"><code>GET /Knowledge/{id}</code></a></td><td>Retorna um conhecimento de agente por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de um conhecimento de agente especificado pelo identificador.</p></details></td><td><code>zild_get_knowledge_id_38263d11e5b5</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Knowledge-id"><code>PUT /Knowledge/{id}</code></a></td><td>Atualiza um conhecimento de agente<details><summary>Descrição da API</summary><p>Este endpoint atualiza os dados de um conhecimento de agente existente identificado pelo id.</p></details></td><td><code>zild_put_knowledge_id_0281d0a89020</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Knowledge-id"><code>DELETE /Knowledge/{id}</code></a></td><td>Remove um conhecimento de agente<details><summary>Descrição da API</summary><p>Este endpoint remove um conhecimento de agente existente identificado pelo id.</p></details></td><td><code>zild_delete_knowledge_id_89360176d8fb</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Skill"><code>GET /Skill</code></a></td><td>Retorna todas as skills visiveis<details><summary>Descrição da API</summary><p>Este endpoint retorna as skills do tenant e as skills globais habilitadas.</p></details></td><td><code>zild_get_skill_a0e49fd5d860</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Skill"><code>POST /Skill</code></a></td><td>Cria uma nova skill<details><summary>Descrição da API</summary><p>Este endpoint cria uma nova skill para o tenant atual.</p></details></td><td><code>zild_post_skill_0713798a9d8e</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Skill-id"><code>GET /Skill/{id}</code></a></td><td>Retorna uma skill por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de uma skill especificada pelo identificador.</p></details></td><td><code>zild_get_skill_id_dcc59e89d18c</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Skill-id"><code>PUT /Skill/{id}</code></a></td><td>Atualiza uma skill<details><summary>Descrição da API</summary><p>Este endpoint atualiza uma skill do tenant atual.</p></details></td><td><code>zild_put_skill_id_b44b2e0a722a</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Skill-id"><code>DELETE /Skill/{id}</code></a></td><td>Remove uma skill<details><summary>Descrição da API</summary><p>Este endpoint remove uma skill do tenant atual.</p></details></td><td><code>zild_delete_skill_id_97756762ea5e</code></td></tr></tbody></table>



## Voz (8)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/post-api-Agent-create-batch-call"><code>POST /Agent/create-batch-call</code></a></td><td>Creates batch calls<details><summary>Descrição da API</summary><p>This endpoint creates multiple batch phone calls for an ElevenLabs agent.</p></details></td><td><code>zild_post_agent_create_batch_call_47019dde720e</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Agent-create-phone-call"><code>POST /Agent/create-phone-call</code></a></td><td>Creates a phone call<details><summary>Descrição da API</summary><p>This endpoint creates a phone call for an ElevenLabs agent.</p></details></td><td><code>zild_post_agent_create_phone_call_016b07989851</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Agent-elevenlabs-llms"><code>GET /Agent/elevenlabs-llms</code></a></td><td>Returns available ElevenLabs LLMs<details><summary>Descrição da API</summary><p>This endpoint returns the available ElevenLabs LLM models and safe capabilities for use with agents.</p></details></td><td><code>zild_get_agent_elevenlabs_llms_e8a97b6a9c1a</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Agent-voice"><code>GET /Agent/voice</code></a></td><td>Returns available voices by provider<details><summary>Descrição da API</summary><p>This endpoint returns the available voices from a specific provider (ElevenLabs) for use with agents.</p></details></td><td><code>zild_get_agent_voice_dc6eb2b3c727</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Agent-voice-tools"><code>GET /Agent/voice-tools</code></a></td><td>Returns available voice tools for the current tenant<details><summary>Descrição da API</summary><p>Lists ElevenLabs tools referenced by the tenant. When agentId is greater than zero, also includes tools currently assigned to that ElevenLabs agent after checking view permission. Fetches tool details from ElevenLabs and returns them sorted by name; it does not execute tools.</p></details></td><td><code>zild_get_agent_voice_tools_db8d77c2d139</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Agent-voice-tools"><code>POST /Agent/voice-tools</code></a></td><td>References a voice tool for the current tenant<details><summary>Descrição da API</summary><p>Registers a tenant reference to an existing custom ElevenLabs tool. ToolId must match tool_ followed by letters or digits, and the tool must exist in the configured ElevenLabs account. System tools cannot be referenced. This operation does not create or execute the external tool and does not duplicate an existing reference.</p></details></td><td><code>zild_post_agent_voice_tools_9dfb174a1297</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Agent-voice-tools-toolId"><code>DELETE /Agent/voice-tools/{toolId}</code></a></td><td>Removes a voice tool reference from the current tenant<details><summary>Descrição da API</summary><p>Removes the tenant reference to the specified ElevenLabs tool after checking edit permission using agentId. This removes the reference stored in the connector; it does not delete the external tool or change the tools configured on the ElevenLabs agent.</p></details></td><td><code>zild_delete_agent_voice_tools_toolid_12ad2ce67a14</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Conversation-create-phone-call-to-user"><code>POST /Conversation/create-phone-call-to-user</code></a></td><td>Cria ligação telefônica para usuário<details><summary>Descrição da API</summary><p>Este endpoint cria uma ligação telefônica para um usuário interno e conecta com o cliente.</p></details></td><td><code>zild_post_conversation_create_phone_call_to_user_1bce95be18d5</code></td></tr></tbody></table>



## Insight (12)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/get-api-Checklist"><code>GET /Checklist</code></a></td><td>Retorna todos os checklists<details><summary>Descrição da API</summary><p>Este endpoint retorna todos os checklists cadastrados.</p></details></td><td><code>zild_get_checklist_3746e42fc684</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Checklist"><code>POST /Checklist</code></a></td><td>Cria um novo checklist<details><summary>Descrição da API</summary><p>Este endpoint cria um novo checklist com os dados fornecidos.</p></details></td><td><code>zild_post_checklist_a430b4271aaa</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Checklist-id"><code>GET /Checklist/{id}</code></a></td><td>Retorna um checklist por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de um checklist especificado pelo identificador.</p></details></td><td><code>zild_get_checklist_id_5c69f4f7ae5c</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Checklist-id"><code>PUT /Checklist/{id}</code></a></td><td>Atualiza um checklist<details><summary>Descrição da API</summary><p>Este endpoint atualiza os dados de um checklist existente identificado pelo id.</p></details></td><td><code>zild_put_checklist_id_66bd7e5ebc5e</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-ChecklistItem"><code>GET /ChecklistItem</code></a></td><td>Retorna itens de checklist por checklist<details><summary>Descrição da API</summary><p>Este endpoint retorna os itens de um checklist específico.</p></details></td><td><code>zild_get_checklistitem_c37c1db2ddf1</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-ChecklistItem"><code>POST /ChecklistItem</code></a></td><td>Cria um novo item de checklist<details><summary>Descrição da API</summary><p>Este endpoint cria um novo item de checklist com os dados fornecidos.</p></details></td><td><code>zild_post_checklistitem_8b86e2e97c31</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-ChecklistItem-id"><code>GET /ChecklistItem/{id}</code></a></td><td>Retorna um item de checklist por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de um item de checklist especificado pelo identificador.</p></details></td><td><code>zild_get_checklistitem_id_cc26b8f6ee14</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-ChecklistItem-id"><code>PUT /ChecklistItem/{id}</code></a></td><td>Atualiza um item de checklist<details><summary>Descrição da API</summary><p>Este endpoint atualiza os dados de um item de checklist existente identificado pelo id.</p></details></td><td><code>zild_put_checklistitem_id_65b9c680cc19</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-ChecklistItem-id"><code>DELETE /ChecklistItem/{id}</code></a></td><td>Deleta um item de checklist<details><summary>Descrição da API</summary><p>Este endpoint deleta um item de checklist. Só é possível deletar se o item não estiver vinculado a nenhuma conversa.</p></details></td><td><code>zild_delete_checklistitem_id_93f545623262</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Conversation-reevaluate"><code>POST /Conversation/reevaluate</code></a></td><td>Reavalia checklist da conversa<details><summary>Descrição da API</summary><p>Este endpoint dispara a reavaliação do checklist de uma ou mais conversas.</p></details></td><td><code>zild_post_conversation_reevaluate_dda3800e6e85</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Insight-audio"><code>POST /Insight/audio</code></a></td><td>Importa conversa de áudio para processamento do Zild Insight<details><summary>Descrição da API</summary><p>Este endpoint cria uma conversa a partir de um arquivo de audio e metadados.</p></details></td><td><code>zild_post_insight_audio_28eeb9723766</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Insight-import-ms-teams"><code>POST /Insight/import-ms-teams</code></a></td><td>Importa conversas do Microsoft Teams para processamento do Zild Insight<details><summary>Descrição da API</summary><p>Este endpoint importa conversas originadas do Microsoft Teams.</p></details></td><td><code>zild_post_insight_import_ms_teams_8e5a295feb9a</code></td></tr></tbody></table>



## Assist (8)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/post-api-Conversation-email"><code>POST /Conversation/email</code></a></td><td>Recebe e responde e-mails<details><summary>Descrição da API</summary><p>Este endpoint recebe e e-mails e envia para o Agente de IA responder.</p></details></td><td><code>zild_post_conversation_email_e7e79d806db1</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Conversation-whatsapp-proactive-conversation"><code>POST /Conversation/whatsapp-proactive-conversation</code></a></td><td>Cria conversa proativa no WhatsApp<details><summary>Descrição da API</summary><p>Este endpoint cria uma conversa proativa com os dados fornecidos.</p></details></td><td><code>zild_post_conversation_whatsapp_proactive_conversation_31db3875643e</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-ConversationTemplate"><code>GET /ConversationTemplate</code></a></td><td>Retorna templates de WhatsApp por filtro<details><summary>Descrição da API</summary><p>Este endpoint retorna templates de conversa conforme os filtros informados.</p></details></td><td><code>zild_get_conversationtemplate_84bbce40064c</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-ConversationTemplate"><code>POST /ConversationTemplate</code></a></td><td>Cria um novo template de WhatsApp<details><summary>Descrição da API</summary><p>Este endpoint cria um novo template de conversa com os dados fornecidos.</p></details></td><td><code>zild_post_conversationtemplate_2db9c29b2e15</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-ConversationTemplate-id"><code>GET /ConversationTemplate/{id}</code></a></td><td>Retorna um template de WhatsApp por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de um template de conversa especificado pelo identificador.</p></details></td><td><code>zild_get_conversationtemplate_id_81a744baeb1f</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-ConversationTemplate-id"><code>PUT /ConversationTemplate/{id}</code></a></td><td>Atualiza um template de WhatsApp<details><summary>Descrição da API</summary><p>Este endpoint atualiza os dados de um template de conversa existente identificado pelo id.</p></details></td><td><code>zild_put_conversationtemplate_id_86000cb2a10c</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-ConversationTemplate-id"><code>DELETE /ConversationTemplate/{id}</code></a></td><td>Deleta um template de WhatsApp<details><summary>Descrição da API</summary><p>Este endpoint deleta template de WhatsApp.</p></details></td><td><code>zild_delete_conversationtemplate_id_78c6d16c4f7e</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-ConversationTemplate-id-check-approval"><code>POST /ConversationTemplate/{id}/check-approval</code></a></td><td>Verifica manualmente o status de aprovação<details><summary>Descrição da API</summary><p>Este endpoint dispara uma verificação manual do status de aprovação do template de conversa no provedor.</p></details></td><td><code>zild_post_conversationtemplate_id_check_approval_6108a4e38afc</code></td></tr></tbody></table>



## Conversas e mensagens (9)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/post-api-Conversation-export"><code>POST /Conversation/export</code></a></td><td>Exporta conversas por filtro<details><summary>Descrição da API</summary><p>Este endpoint retorna todas as conversas que atendem ao filtro informado, com itens de checklist opcionais.</p></details></td><td><code>zild_post_conversation_export_83914eb76ba2</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Conversation-paged"><code>GET /Conversation/paged</code></a></td><td>Retorna conversas paginadas<details><summary>Descrição da API</summary><p>Este endpoint retorna as conversas paginadas conforme o filtro informado.</p></details></td><td><code>zild_get_conversation_paged_8777cc7449d2</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Conversation-id"><code>GET /Conversation/{id}</code></a></td><td>Retorna uma conversa por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de uma conversa especificada pelo identificador.</p></details></td><td><code>zild_get_conversation_id_499ae9457461</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Message"><code>GET /Message</code></a></td><td>Retorna mensagens por conversa<details><summary>Descrição da API</summary><p>Este endpoint retorna as mensagens de uma conversa especificada pelo identificador da conversa.</p></details></td><td><code>zild_get_message_f14013758dfb</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Message"><code>POST /Message</code></a></td><td>Cria uma nova mensagem<details><summary>Descrição da API</summary><p>Este endpoint cria uma nova mensagem, opcionalmente com arquivo, para uma conversa.</p></details></td><td><code>zild_post_message_dd1c2cb71f86</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Message-resend"><code>POST /Message/resend</code></a></td><td>Reenvia uma mensagem<details><summary>Descrição da API</summary><p>Este endpoint reenvia uma mensagem já existente pelo seu identificador.</p></details></td><td><code>zild_post_message_resend_11e4db8122c8</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Message-id"><code>GET /Message/{id}</code></a></td><td>Retorna uma mensagem por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de uma mensagem especificada pelo identificador.</p></details></td><td><code>zild_get_message_id_e2575153d29b</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Message-id"><code>PUT /Message/{id}</code></a></td><td>Atualiza uma mensagem<details><summary>Descrição da API</summary><p>Este endpoint atualiza os dados de uma mensagem existente identificada pelo id.</p></details></td><td><code>zild_put_message_id_19b6e597d699</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Message-messageId-read"><code>PUT /Message/{messageId}/read</code></a></td><td>Marca uma mensagem como lida pelo usuário<details><summary>Descrição da API</summary><p>Este endpoint marca uma mensagem específica como lida pelo usuário.</p></details></td><td><code>zild_put_message_messageid_read_6b89be4f8644</code></td></tr></tbody></table>



## Documentos (6)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/post-api-Document"><code>POST /Document</code></a></td><td>Cria um novo documento<details><summary>Descrição da API</summary><p>Este endpoint cria um novo documento, opcionalmente com arquivo, com os dados fornecidos.</p></details></td><td><code>zild_post_document_550502414b9f</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Document-dashboard"><code>GET /Document/dashboard</code></a></td><td>Retorna dashboard de documentos<details><summary>Descrição da API</summary><p>Este endpoint retorna informações resumidas e estatísticas dos documentos para exibição em dashboard. Permite filtrar por período (createdAtStart e createdAtEnd).</p></details></td><td><code>zild_get_document_dashboard_947fd643a756</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Document-paged"><code>GET /Document/paged</code></a></td><td>Retorna documentos paginados<details><summary>Descrição da API</summary><p>Este endpoint retorna documentos paginados conforme o filtro informado.</p></details></td><td><code>zild_get_document_paged_090de02b746f</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Document-id"><code>GET /Document/{id}</code></a></td><td>Retorna um documento por id<details><summary>Descrição da API</summary><p>Este endpoint retorna os detalhes de um documento especificado pelo identificador.</p></details></td><td><code>zild_get_document_id_a13894680bb2</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Document-id"><code>DELETE /Document/{id}</code></a></td><td>Remove um documento<details><summary>Descrição da API</summary><p>Este endpoint remove um documento existente identificado pelo id.</p></details></td><td><code>zild_delete_document_id_5ecae91db708</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Document-id-reprocess"><code>POST /Document/{id}/reprocess</code></a></td><td>Reprocessa um documento<details><summary>Descrição da API</summary><p>Este endpoint reprocessa um documento existente identificado pelo id.</p></details></td><td><code>zild_post_document_id_reprocess_1470ac0c91a9</code></td></tr></tbody></table>



## Flow (24)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/get-api-Flow"><code>GET /Flow</code></a></td><td>Lista fluxos<details><summary>Descrição da API</summary><p>Retorna a lista de fluxos do tenant do usuário autenticado.</p></details></td><td><code>zild_get_flow_96ec9435526f</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Flow"><code>POST /Flow</code></a></td><td>Cria fluxo<details><summary>Descrição da API</summary><p>Cria um registro de fluxo com os dados do corpo da requisição e retorna o registro criado.</p></details></td><td><code>zild_post_flow_1c87790c6811</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Flow-dashboard"><code>GET /Flow/dashboard</code></a></td><td>Consulta indicadores de fluxos e tarefas<details><summary>Descrição da API</summary><p>Retorna os totais dos fluxos com tarefas que atendem aos filtros, tarefas por status e tarefas com participação de usuários ou agentes registrada no histórico. Permite filtrar por fluxo, status e intervalos inclusivos de criação e conclusão. Agrupa os períodos pela data de criação das tarefas, por dia ou mês; o padrão é dia. Uma tarefa pode ser contada tanto na participação humana quanto na de IA. Não altera tarefas nem executa agentes.</p></details></td><td><code>zild_get_flow_dashboard_2bd2884833bd</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Flow-id"><code>GET /Flow/{id}</code></a></td><td>Consulta fluxo por ID<details><summary>Descrição da API</summary><p>Retorna os dados de fluxo identificado por id no tenant do usuário autenticado. Retorna 404 quando o registro não é encontrado.</p></details></td><td><code>zild_get_flow_id_20b7d8a0b4cb</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Flow-id"><code>PUT /Flow/{id}</code></a></td><td>Atualiza fluxo<details><summary>Descrição da API</summary><p>Atualiza os dados de fluxo identificado por id usando o corpo da requisição. Retorna 204 sem conteúdo.</p></details></td><td><code>zild_put_flow_id_f734ee12eaf9</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Flow-id"><code>DELETE /Flow/{id}</code></a></td><td>Exclui fluxo<details><summary>Descrição da API</summary><p>Exclui o registro de fluxo identificado por id. Retorna 204 sem conteúdo.</p></details></td><td><code>zild_delete_flow_id_e2092f067f1d</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-FlowRecurringTask"><code>GET /FlowRecurringTask</code></a></td><td>Lista recorrências de tarefas<details><summary>Descrição da API</summary><p>Retorna a lista de recorrências de tarefas do tenant do usuário autenticado.</p></details></td><td><code>zild_get_flowrecurringtask_697550d65a44</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-FlowRecurringTask"><code>POST /FlowRecurringTask</code></a></td><td>Cria recorrência de tarefas<details><summary>Descrição da API</summary><p>Cadastra uma regra de geração recorrente de tarefas para um fluxo e uma raia do mesmo tenant. Informe título, padrão, intervalo, data e horário locais, fuso horário e limite da recorrência. Valida a regra e calcula a primeira ocorrência em UTC; esta requisição cadastra a recorrência, sem gerar tarefas imediatamente.</p></details></td><td><code>zild_post_flowrecurringtask_8810293f9983</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-FlowRecurringTask-id"><code>GET /FlowRecurringTask/{id}</code></a></td><td>Consulta recorrência de tarefas por ID<details><summary>Descrição da API</summary><p>Retorna os dados de recorrência de tarefas identificado por id no tenant do usuário autenticado. Retorna 404 quando o registro não é encontrado.</p></details></td><td><code>zild_get_flowrecurringtask_id_43d0afac3c48</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-FlowRecurringTask-id"><code>PUT /FlowRecurringTask/{id}</code></a></td><td>Atualiza recorrência de tarefas<details><summary>Descrição da API</summary><p>Atualiza a regra de recorrência identificada por id e recalcula a próxima ocorrência em UTC. Preserva a quantidade de ocorrências já geradas e a última ocorrência. Informe os dados completos da regra; o fluxo e a raia devem pertencer ao mesmo tenant e a raia ao fluxo selecionado.</p></details></td><td><code>zild_put_flowrecurringtask_id_3ff560e8c0df</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-FlowRecurringTask-id"><code>DELETE /FlowRecurringTask/{id}</code></a></td><td>Exclui recorrência de tarefas<details><summary>Descrição da API</summary><p>Exclui o registro de recorrência de tarefas identificado por id. Retorna 204 sem conteúdo.</p></details></td><td><code>zild_delete_flowrecurringtask_id_84b453427dbc</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-FlowRecurringTask-id-occurrences"><code>GET /FlowRecurringTask/{id}/occurrences</code></a></td><td>Consulta próximas ocorrências de uma recorrência<details><summary>Descrição da API</summary><p>Retorna a previsão das próximas ocorrências, considerando exceções ainda não processadas, reagendamentos e cancelamentos. Os horários original e agendado são retornados em UTC, ordenados pelo horário agendado. O parâmetro count tem padrão 50 e é ajustado ao intervalo de 1 a 200. A consulta não gera tarefas nem executa agentes.</p></details></td><td><code>zild_get_flowrecurringtask_id_occurrences_7b9cfd2c5eed</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-FlowStage"><code>POST /FlowStage</code></a></td><td>Cria raia de fluxo<details><summary>Descrição da API</summary><p>Cadastra uma raia vinculada a um fluxo, com nome, ordem, responsáveis, sinalizadores de início e fim, cor e limite de tarefas em andamento (WipLimit).</p></details></td><td><code>zild_post_flowstage_934c823962a8</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-FlowStage-id"><code>GET /FlowStage/{id}</code></a></td><td>Consulta raia de fluxo por ID<details><summary>Descrição da API</summary><p>Retorna os dados de raia de fluxo identificado por id no tenant do usuário autenticado. Retorna 404 quando o registro não é encontrado.</p></details></td><td><code>zild_get_flowstage_id_8bfd64888c75</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-FlowStage-id"><code>PUT /FlowStage/{id}</code></a></td><td>Atualiza raia de fluxo<details><summary>Descrição da API</summary><p>Atualiza os dados da raia identificada por id. Informe o fluxo, nome, ordem, responsáveis e demais configurações no corpo da requisição.</p></details></td><td><code>zild_put_flowstage_id_4082b0d7d100</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-FlowStage-id"><code>DELETE /FlowStage/{id}</code></a></td><td>Exclui raia de fluxo<details><summary>Descrição da API</summary><p>Exclui o registro de raia de fluxo identificado por id. Retorna 204 sem conteúdo.</p></details></td><td><code>zild_delete_flowstage_id_c30ed03e7b3d</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-FlowTask"><code>POST /FlowTask</code></a></td><td>Cria tarefa de fluxo<details><summary>Descrição da API</summary><p>Cadastra uma tarefa vinculada a um fluxo e uma raia, com título, descrição, status, prioridade, payload e prazo informados no corpo da requisição.</p></details></td><td><code>zild_post_flowtask_c6a8b9e48578</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-FlowTask-id"><code>GET /FlowTask/{id}</code></a></td><td>Consulta tarefa de fluxo por ID<details><summary>Descrição da API</summary><p>Retorna os dados de tarefa de fluxo identificado por id no tenant do usuário autenticado. Retorna 404 quando o registro não é encontrado.</p></details></td><td><code>zild_get_flowtask_id_0715b21cc925</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-FlowTask-id"><code>PUT /FlowTask/{id}</code></a></td><td>Atualiza tarefa de fluxo<details><summary>Descrição da API</summary><p>Atualiza a tarefa identificada por id. Se CurrentFlowStageId mudar, a operação move a tarefa para a raia de destino e pode agendar a execução do agente responsável por essa raia; nesse caso, os demais campos enviados não são atualizados por esta operação. Sem mudança de raia, atualiza os dados da tarefa pelo comportamento de atualização comum. A movimentação pode produzir efeitos externos pela execução do agente.</p></details></td><td><code>zild_put_flowtask_id_4536d5c7b0aa</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-FlowTask-id"><code>DELETE /FlowTask/{id}</code></a></td><td>Exclui tarefa de fluxo<details><summary>Descrição da API</summary><p>Exclui o registro de tarefa de fluxo identificado por id. Retorna 204 sem conteúdo.</p></details></td><td><code>zild_delete_flowtask_id_8cd5dc4068f6</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-FlowTaskHistory"><code>POST /FlowTaskHistory</code></a></td><td>Cria registro de histórico de tarefa<details><summary>Descrição da API</summary><p>Cadastra um registro de histórico vinculado a uma tarefa, com tipo de evento, raias de origem e destino, usuário ou agente, descrição e payload informados. O registro documenta um evento; esta operação não movimenta a tarefa nem executa agentes.</p></details></td><td><code>zild_post_flowtaskhistory_81d057ceac6f</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-FlowTaskHistory-id"><code>GET /FlowTaskHistory/{id}</code></a></td><td>Consulta registro de histórico de tarefa por ID<details><summary>Descrição da API</summary><p>Retorna os dados de registro de histórico de tarefa identificado por id no tenant do usuário autenticado. Retorna 404 quando o registro não é encontrado.</p></details></td><td><code>zild_get_flowtaskhistory_id_282c16297ad2</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-FlowTaskHistory-id"><code>PUT /FlowTaskHistory/{id}</code></a></td><td>Atualiza registro de histórico de tarefa<details><summary>Descrição da API</summary><p>Atualiza os dados de registro de histórico de tarefa identificado por id usando o corpo da requisição. Retorna 204 sem conteúdo.</p></details></td><td><code>zild_put_flowtaskhistory_id_af5da4c9308d</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-FlowTaskHistory-id"><code>DELETE /FlowTaskHistory/{id}</code></a></td><td>Exclui registro de histórico de tarefa<details><summary>Descrição da API</summary><p>Exclui o registro de registro de histórico de tarefa identificado por id. Retorna 204 sem conteúdo.</p></details></td><td><code>zild_delete_flowtaskhistory_id_b73af511b1da</code></td></tr></tbody></table>



## Conexões MCP de agentes (6)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/get-api-AgentMcpConnection"><code>GET /AgentMcpConnection</code></a></td><td>Lista conexões MCP de um agente<details><summary>Descrição da API</summary><p>Retorna as associações entre o agente informado e conectores MCP do tenant, incluindo o estado de habilitação e os nomes das ferramentas permitidas. Requer ViewAgents.</p></details></td><td><code>zild_get_agentmcpconnection_b356afd8674a</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-AgentMcpConnection"><code>POST /AgentMcpConnection</code></a></td><td>Associa conector MCP a um agente<details><summary>Descrição da API</summary><p>Cria uma associação entre agente e conector MCP do mesmo tenant. Informe Enabled e a lista AllowedTools; uma lista vazia não libera ferramentas. Não permite duplicar o mesmo conector para um agente. Requer UpdateAgent e ViewConnectors.</p></details></td><td><code>zild_post_agentmcpconnection_ac7fe73e787f</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-AgentMcpConnection-connectors-connectorId-tools"><code>GET /AgentMcpConnection/connectors/{connectorId}/tools</code></a></td><td>Descobre ferramentas de um conector MCP<details><summary>Descrição da API</summary><p>Conecta ao servidor MCP configurado no conector do tenant e consulta os nomes, descrições e schemas das ferramentas disponíveis. Faz uma chamada ao servidor externo, mas não executa as ferramentas nem as autoriza automaticamente para um agente. Requer ViewConnectors.</p></details></td><td><code>zild_get_agentmcpconnection_connectors_connectorid_tools_87051518c2cc</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-AgentMcpConnection-id"><code>GET /AgentMcpConnection/{id}</code></a></td><td>Consulta conexão MCP por ID<details><summary>Descrição da API</summary><p>Retorna os dados e as ferramentas permitidas da associação MCP identificada por id no tenant autenticado. Requer ViewAgents.</p></details></td><td><code>zild_get_agentmcpconnection_id_bb6fdcef3ddb</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-AgentMcpConnection-id"><code>PUT /AgentMcpConnection/{id}</code></a></td><td>Atualiza habilitação e ferramentas de uma conexão MCP<details><summary>Descrição da API</summary><p>Atualiza Enabled e substitui a lista AllowedTools da associação. AgentId e ConnectorId devem permanecer iguais aos da associação existente; para trocar o agente ou conector, crie outra associação. Requer UpdateAgent e ViewConnectors.</p></details></td><td><code>zild_put_agentmcpconnection_id_1f68ed912428</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-AgentMcpConnection-id"><code>DELETE /AgentMcpConnection/{id}</code></a></td><td>Remove associação MCP de um agente<details><summary>Descrição da API</summary><p>Exclui a associação MCP identificada por id, revogando seu uso pelo agente. Não exclui o agente nem o conector. Requer UpdateAgent.</p></details></td><td><code>zild_delete_agentmcpconnection_id_148a971c1d08</code></td></tr></tbody></table>



## Departamentos e cotas (7)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/get-api-Department"><code>GET /Department</code></a></td><td>Lista departamentos<details><summary>Descrição da API</summary><p>Retorna os departamentos do tenant do usuário autenticado.</p></details></td><td><code>zild_get_department_a3e131e08369</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Department"><code>POST /Department</code></a></td><td>Cria departamento<details><summary>Descrição da API</summary><p>Cria um departamento com nome, cota mensal em BRL e membros informados em TenantUserIds. Os membros devem pertencer ao tenant autenticado. Cota null significa ilimitada; zero bloqueia o uso; valores negativos são inválidos.</p></details></td><td><code>zild_post_department_43fece942628</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Department-tenant-quota"><code>GET /Department/tenant-quota</code></a></td><td>Consulta consumo e cota do tenant<details><summary>Descrição da API</summary><p>Retorna o consumo do mês atual em UTC, o limite mensal e a indicação de bloqueio por cota do tenant autenticado. Não altera limites nem registra consumo.</p></details></td><td><code>zild_get_department_tenant_quota_8768089d032f</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Department-id"><code>GET /Department/{id}</code></a></td><td>Consulta departamento por ID<details><summary>Descrição da API</summary><p>Retorna o departamento identificado por id, incluindo a cota mensal e os IDs de seus membros.</p></details></td><td><code>zild_get_department_id_fb41b8c5b38a</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Department-id"><code>PUT /Department/{id}</code></a></td><td>Atualiza departamento e seus membros<details><summary>Descrição da API</summary><p>Atualiza nome, cota mensal e a lista completa de membros do departamento. Membros omitidos da lista são removidos. TenantUserIds deve conter apenas membros do tenant autenticado. Cota null significa ilimitada; zero bloqueia o uso.</p></details></td><td><code>zild_put_department_id_8a8ac53153c5</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Department-id"><code>DELETE /Department/{id}</code></a></td><td>Exclui departamento<details><summary>Descrição da API</summary><p>Exclui o departamento identificado por id. A operação é recusada enquanto houver agentes vinculados ao departamento; remova esses vínculos antes de excluir.</p></details></td><td><code>zild_delete_department_id_f5a9d0784f15</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Department-id-quota"><code>GET /Department/{id}/quota</code></a></td><td>Consulta consumo e cotas de um departamento<details><summary>Descrição da API</summary><p>Retorna o consumo do mês atual em UTC, os limites do tenant e do departamento e a indicação de bloqueio por cota. Não altera limites nem registra consumo.</p></details></td><td><code>zild_get_department_id_quota_0afaea23dc2d</code></td></tr></tbody></table>



## Consumo (1)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/post-api-ConsumptionDashboard"><code>POST /ConsumptionDashboard</code></a></td><td>Consulta indicadores de consumo<details><summary>Descrição da API</summary><p>Consulta o dashboard de consumo conforme os filtros do corpo da requisição. Retorna um resumo de agentes, valores contratados e consumidos, consumo por item e dia e dimensões de consumo. Apesar de usar POST, esta operação é uma consulta e não registra consumo nem altera cotas.</p></details></td><td><code>zild_post_consumptiondashboard_fc8837cbdfb2</code></td></tr></tbody></table>



## Webhooks (5)



<table class="api-params"><thead><tr><th>Operação e contrato</th><th>Finalidade</th><th>Ferramenta MCP prevista</th></tr></thead><tbody><tr><td><a href="/pt-BR/docs/api-reference/get-api-Webhook"><code>GET /Webhook</code></a></td><td>Lista webhooks<details><summary>Descrição da API</summary><p>Retorna as configurações de webhooks do tenant autenticado, incluindo nome, URL de destino, tipo de evento e estado de habilitação. Requer ViewWebhooks.</p></details></td><td><code>zild_get_webhook_b54d4957d094</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/post-api-Webhook"><code>POST /Webhook</code></a></td><td>Cadastra webhook<details><summary>Descrição da API</summary><p>Cadastra uma configuração de webhook com nome, URL de destino, tipo de evento e estado de habilitação. Não envia uma notificação de teste nesta requisição. Requer CreateWebhook. Retorna 200 sem o registro criado no corpo.</p></details></td><td><code>zild_post_webhook_6c6aed23f6f2</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/get-api-Webhook-id"><code>GET /Webhook/{id}</code></a></td><td>Consulta webhook por ID<details><summary>Descrição da API</summary><p>Retorna a configuração do webhook identificado por id no tenant autenticado. Requer ViewWebhooks.</p></details></td><td><code>zild_get_webhook_id_50ff5d5af22d</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/put-api-Webhook-id"><code>PUT /Webhook/{id}</code></a></td><td>Atualiza webhook<details><summary>Descrição da API</summary><p>Atualiza a configuração do webhook identificado por id usando nome, URL de destino, tipo de evento e habilitação enviados no corpo. Não envia uma notificação de teste nesta requisição. Requer UpdateWebhook. Retorna 200 sem conteúdo.</p></details></td><td><code>zild_put_webhook_id_9b1ec566abb1</code></td></tr><tr><td><a href="/pt-BR/docs/api-reference/delete-api-Webhook-id"><code>DELETE /Webhook/{id}</code></a></td><td>Solicita exclusão de webhook (sem efeito implementado)<details><summary>Descrição da API</summary><p>Esta rota atualmente retorna sucesso sem excluir ou alterar o webhook. A chamada ao serviço de exclusão não está implementada no controller; não use esta operação para confirmar que um webhook foi removido.</p></details></td><td><code>zild_delete_webhook_id_614ae5fb1fbf</code></td></tr></tbody></table>