Sign in
latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-1919701.3 MB

063de6e2e93c

funnel-steps
Movimentação de projetos

Vincular um projeto a uma etapa

Vincula um projeto a uma etapa do funil — o mesmo efeito de arrastar o cartão para a coluna. Antes de aceitar, a plataforma verifica, nessa ordem, se o funil está ativo e vinculado ao projeto, as restrições de entrada e saída, os requisitos pendentes da etapa de origem e os bloqueios por etiqueta ou status; qualquer recusa volta com o detalhe do que impediu. Use unlink_others para mover o projeto (desvinculando as demais etapas do funil) em vez de deixá-lo em etapas simultâneas. A sequência completa está em Mover projetos entre etapas, e as regras em Restrições e bloqueios e Checklists e formulários obrigatórios.

post/api/management/funnel-steps/{funnel_step_id}/projects

Request body

project_idstring uuid required

ID do projeto

unlink_othersboolean

Desvincular projeto das outras etapas do mesmo funil. Use como verdadeiro se estiver tentando mudar o projeto de etapa no funil.

force_funnel_linkboolean

Forçar vínculo do projeto ao funil caso ele não esteja vinculado

Example request

{
  "project_id": "d75b593c-0609-42bf-a722-f99ba9a07daf",
  "unlink_others": true,
  "force_funnel_link": true
}

Response

Sucesso

responseboolean