--- title: "Clonar um funil" method: POST path: "/api/management/clone-funnel" tags: ["project-funnels", "Ciclo de vida"] --- # Clonar um funil `POST /api/management/clone-funnel` Cria uma cópia do funil com toda a configuração — etapas, checklists, restrições, etiquetas, status, anexos, automações, assistentes, modelos de configurações de visualização, permissões e templates de projeto (sem trazer os projetos reais). Sem `name`, a cópia recebe o nome do original seguido de ` (Clone)`. Funis arquivados não podem ser clonados. **O que clonar:** cada categoria pode ser desligada individualmente pelas flags booleanas do corpo. Flag omitida ou `null` equivale a `true`, então uma chamada sem flags clona tudo. **Dependências forçadas:** algumas categorias são ligadas automaticamente quando outra depende delas. Se `automations`, `step_restrictions` ou `funnel_step_blockings` estiver `true`, então `funnel_tags` e `funnel_statuses` viram `true` mesmo que enviados como `false`. Se `automations` estiver `true`, `step_assistants` também vira `true`. Ou seja, desligar etiquetas/status só tem efeito quando os três primeiros estão `false`. O funil, as etapas, os vínculos de formulário e a área de negócio são sempre clonados e não têm flag. Formulários, agentes de IA e áreas de negócio são reaproveitados (não duplicados). Ver [Criar e configurar um funil](https://docs.olie.ai/guides/funnels/creating-funnels). ## Request body - object - `project_funnel_id` integer, required — ID do funil a clonar. Obrigatório. - `name` string, nullable — Nome do funil clonado. Sem ele, o nome vira o do original seguido de ` (Clone)`. Máximo de 255 caracteres. - `automations` boolean, nullable — Automações: copia as automações ligadas às etapas deste funil. Quando true, força `funnel_tags`, `funnel_statuses` e `step_assistants`. Padrão true. - `step_restrictions` boolean, nullable — Restrições: copia as restrições das etapas. Quando true, força `funnel_tags` e `funnel_statuses`. Padrão true. - `step_assistants` boolean, nullable — Assistentes: copia os vínculos de assistente nas etapas (os agentes existentes são reutilizados). Forçado para true quando `automations` é true. Padrão true. - `step_checklists` boolean, nullable — Checklists: copia os checklists das etapas. Padrão true. - `funnel_step_blockings` boolean, nullable — Bloqueio de etapas: copia os bloqueios de etapas das etiquetas/status do funil. Quando true, força `funnel_tags` e `funnel_statuses`. Padrão true. - `funnel_tags` boolean, nullable — Etiquetas: copia as etiquetas do funil. Obrigatório enquanto automações, restrições ou bloqueios estiverem marcados — só tem efeito como false quando `automations`, `step_restrictions` e `funnel_step_blockings` estão todos false. Padrão true. - `funnel_statuses` boolean, nullable — Status: copia os status do funil. Obrigatório enquanto automações, restrições ou bloqueios estiverem marcados — só tem efeito como false quando `automations`, `step_restrictions` e `funnel_step_blockings` estão todos false. Padrão true. - `funnel_attachments` boolean, nullable — Anexos: copia anexos do funil e vínculos de anexo nas etapas. Padrão true. - `funnel_config_templates` boolean, nullable — Modelos de configurações de visualização: copia modelos de configurações de visualização do funil. Padrão true. - `permissions` boolean, nullable — Permissões: replica permissões de acesso do funil original para o clone. Padrão true. - `template_projects` boolean, nullable — Templates de projeto: copia os vínculos com templates de projeto do funil original. Padrão true. ## Response `200` Sucesso - object - `response` boolean, required — Sempre true quando a operação é concluída. - `project_funnel` object, required — Funil de projeto. - `id` integer — ID do funil. - `name` string — Nome do funil. - `prefix` string, nullable — Prefixo usado no código dos projetos do funil. - `order` integer — Posição do funil na ordem de exibição. - `condition` 'active' | 'inactive' — Situação do funil. - `allow_multi_step` boolean — Indica se o projeto pode ocupar várias etapas ao mesmo tempo. - `project_term` object, nullable — Vocabulário do funil para o termo 'projeto'. - `show_cost_info` boolean — Indica se as informações de custo aparecem no funil. - `allow_execution` boolean — Indica se o funil permite cronometrar execução. - `business_area_id` integer, nullable — ID da área de negócio do funil. - `form_id` integer, nullable — ID do formulário de vínculo do funil. - `funnel_config_template_id` integer, nullable — Modelo de configuração de quadro em uso. - `frame_id` string, uuid — ID (UUID) da conta dona do funil. - `created_at` string, date-time — Data de criação. - `updated_at` string, date-time — Data da última alteração. - `deleted_at` string, date-time, nullable — Data de arquivamento, quando o funil está arquivado. ## Other responses - `422` — Funil arquivado, validação inválida ou falha parcial do clone ## Changes - **2026-08-28** `8c9bac94e5ad` — 5 warning, 11 info - the `name` request property's maxLength was set to `255` - added the new `cant_clone_archived_project_funnel` enum value to the `message` response property for the response status `422` - added the new `funnel_clone_missing_funnel` enum value to the `message` response property for the response status `422` - added the new `funnel_clone_partial_failure` enum value to the `message` response property for the response status `422` - …12 more - **2026-08-24** `3c590152d5b5` — 10 breaking, 2 warning, 4 info - the request property `project_funnel_id` became not nullable - the request property `project_funnel_id` became required - the `name` request property type changed from no type to `string` - the `project_funnel_id` request property type changed from no type to `integer` - …12 more - **2026-08-19** `159cf36842c5` — 2 info - added the media type `application/json` for the response with the status `200` - added the non-success response with the status `422` - **2026-08-19** `f521a8dfa4f7` — 1 info - added optional request body - **2026-08-19** `f3efb100a3fc` — 2 info - api tag `Ciclo de vida` added - api tag `{project_funnel_id}` removed [Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/clone-funnel/post.md) --- [API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/8c9bac94e5ad/schema)