Sign in
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 (UUID) do projeto a vincular. Obrigatório.

unlink_othersboolean

Quando true, desvincula o projeto das demais etapas do mesmo funil — o comportamento de mover o cartão. Também dispara a checagem de requisitos da etapa de origem.

force_funnel_linkboolean

Quando true, vincula o projeto ao funil caso ainda não esteja vinculado, em vez de recusar com project_funnel_not_linked_with_project.

Response

Sucesso

responseboolean required

Sempre true quando a operação é concluída.

Changes