---
title: "Mover múltiplos projetos de etapa"
method: POST
path: "/api/management/project-bulk-step-move"
tags: ["funnel-steps", "Movimentação de projetos"]
---

# Mover múltiplos projetos de etapa

`POST /api/management/project-bulk-step-move`

Aplica a mesma movimentação a vários projetos de uma vez, com as mesmas verificações da movimentação individual. Projetos que já estão na etapa de destino são ignorados sem erro; qualquer outra recusa — restrição, requisito pendente ou bloqueio — interrompe o lote no projeto em que ocorreu, e os projetos seguintes da lista não são processados. As verificações estão descritas em [Mover projetos entre etapas](https://docs.olie.ai/guides/funnels/moving-projects).

## Request body

- object
  - `project_ids` string[], required — Projetos a mover. Obrigatório.
  - `step_id` integer, required — ID da etapa de destino. Obrigatório.
  - `unlink_others` boolean — Quando true, desvincula cada projeto das demais etapas do mesmo funil.
  - `force_funnel_link` boolean — Quando true, vincula ao funil os projetos que ainda não estiverem vinculados.

## Response `200`

Sucesso

- object
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `projects` object[], required — Projetos processados, na ordem enviada.
    - `id` string, uuid — ID (UUID) do projeto.
    - `parent_id` string, uuid, nullable — ID do projeto pai, quando é um subprojeto.
    - `code` string — Código do projeto, com o prefixo do funil.
    - `name` string — Nome do projeto.
    - `description` string, nullable — Descrição do projeto.
    - `impact` integer, nullable — Grau de impacto do projeto.
    - `budget` number, nullable — Orçamento do projeto.
    - `frame_id` string, uuid — ID (UUID) da conta dona do projeto.
    - `created_at` string, date-time — Data de criação.
    - `updated_at` string, date-time — Data da última alteração.

## Other responses

- `422` — Validação falhou

## Changes

- **2026-08-24** `3c590152d5b5` — 10 breaking, 1 warning, 6 info
  - the request property `step_id` became not nullable
  - the request property `project_ids` became required
  - the request property `step_id` became required
  - the `project_ids/items/` request property type changed from no type to `string`, and format from no format to `uuid`
  - …13 more
- **2026-08-19** `a7c4c54005a5` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `422`
- **2026-08-19** `d6832ed1714a` — 1 info
  - added optional request body
- **2026-08-19** `d85127746782` — 2 info
  - api tag `Movimentação de projetos` added
  - api tag `project-bulk-step-move` removed

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/project-bulk-step-move/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-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/8c9bac94e5ad/schema)