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

Changed in 2 of the 80 revisions of this API.5814

Aug 24, 20263c590152d5b55811See the full diff
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the / response's property type changed from integer to number for status
  response-property-type-changed
- ▲
  the / response's property type changed from no type to object for status
  response-property-type-changed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
Aug 19, 2026d851277467823See the full diff
- ○
  api tag Movimentação de projetos added
  api-tag-added
- ○
  api tag projects removed
  api-tag-removed
- ○
  api tag {funnel_step_id} removed
  api-tag-removed

Full history