Skip to main content
Etapas são as colunas do quadro. Cada etapa pertence a uma pipeline e tem uma position que define sua ordem. Todas as rotas desta página exigem a permissão pipeline.manage.
Para criar ou reordenar várias etapas de uma vez, prefira Configurar pipeline — é uma operação transacional que salva a lista completa.

O objeto Etapa

string
UUID da etapa
string
Nome exibido no topo da coluna
string
Cor no formato de token "H S% L%" (tripla HSL sem o invólucro hsl())
string
won, lost ou ausente para uma etapa comum
integer
Ordem da coluna no quadro (base 0)

Criar etapa

POST /backend/pipelines/{id}/stages
Adiciona uma etapa comum ao fim da pipeline. Não é possível criar etapas won ou lost — elas já existem desde a criação da pipeline.

Request Body

string
obrigatório
Nome da etapa
string
Cor no formato "H S% L%". Quando omitida, usa o cinza padrão "215 16% 47%".

Atualizar etapa

PUT /backend/pipeline/stages/{id}
Renomeia, recolore ou reposiciona uma etapa. Campos omitidos permanecem inalterados.

Request Body

string
Novo nome
string
Nova cor no formato "H S% L%"
integer
Nova posição no quadro
As etapas won e lost podem ser renomeadas e recoloridas normalmente — o kind é que não muda.

Excluir etapa

DELETE /backend/pipeline/stages/{id}

Query Parameters

string
Etapa que receberá os negócios da etapa excluída. Obrigatório quando a etapa ainda contém negócios.
Excluir uma etapa que ainda tem negócios sem target_stage_id retorna 409. Os negócios nunca são apagados junto com a etapa — a API obriga a escolher um destino.
O destino precisa pertencer à mesma pipeline e não pode ser a própria etapa sendo excluída — ambos os casos retornam 400.
As etapas de Ganho (kind: "won") e Perdido (kind: "lost") não podem ser excluídas (400), porque não existe rota que as recrie. A pipeline também precisa manter pelo menos uma etapa.
Fluxo recomendado na interface: tente o DELETE sem target_stage_id; se vier 409, pergunte ao usuário para onde mover os negócios e repita com o parâmetro.