---
title: "Desvincular um projeto da etapa do funil"
method: POST
path: "/api/management/unlink-project-from-funnel-step"
tags: ["funnel-steps", "Movimentação de projetos"]
---

# Desvincular um projeto da etapa do funil

`POST /api/management/unlink-project-from-funnel-step`

Desvincula um projeto de uma etapa específica do funil, removendo o card daquela etapa. Só é possível quando o projeto está vinculado a mais de uma etapa do mesmo funil: se aquela for a única, a operação é recusada. A desvinculação fica registrada no histórico de atividades do projeto. Ver [Mover projetos entre etapas](https://docs.olie.ai/guides/funnels/moving-projects).

## Request body

- object
  - `project_id` string, uuid, required — ID (UUID) do projeto que será desvinculado da etapa. Obrigatório.
  - `funnel_step_id` integer, required — ID da etapa do funil da qual o projeto será desvinculado. Obrigatório.

## Response `200`

Sucesso

- object
  - `response` boolean, required — Sempre true quando a desvinculação é concluída.

## Other responses

- `403` — Sem permissão
- `404` — Projeto não encontrado
- `422` — Única etapa vinculada

## Changes

- **2026-08-24** `3c590152d5b5` — 7 breaking, 10 info
  - the request property `funnel_step_id` became not nullable
  - the request property `project_id` became not nullable
  - the request property `funnel_step_id` became required
  - the request property `project_id` became required
  - …13 more
- **2026-08-19** `d85127746782` — 2 info
  - api tag `Movimentação de projetos` added
  - api tag `unlink-project-from-funnel-step` removed
- **2026-08-19** `a36725399466` — 5 info
  - added optional request body
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - …1 more

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/unlink-project-from-funnel-step/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.dev/olie-ai/apis/olie-api/revisions/d71b18b1685d?raw)