Vincular um projeto a uma etapa

Changed on Oct 7, 2026

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 com active: true, os requisitos pendentes da etapa de origem e os bloqueios por etiqueta ou status; qualquer recusa volta com o detalhe do que impediu. Restrições inativas ficam salvas e são ignoradas nessa verificação. 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

Base URL: https://api.olie.ai
URL: https://api.olie.ai/api/management/funnel-steps/{funnel_step_id}/projects
Auth: HTTP bearer

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. Opcional; sem o campo, vale false.

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. Opcional; sem o campo, vale false.

skip_if_already_linkedboolean

Quando true, se o projeto já estiver na etapa de destino a operação conclui sem erro e sem alteração. Sem esse campo (ou com false), a plataforma recusa com project_already_linked_to_that_step.

Response

Sucesso

responseboolean required

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

Changes

Oct 7, 2026a72f02438831 Revision changes
- info
  added the new optional request property
Aug 24, 20263c590152d5b5 Revision changes
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the / response's property type changed from integer to number for status
- breaking
  the / response's property type changed from no type to object for status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status

Operation history (3 revisions)