Etapas

Etapas são as colunas do Kanban. Cada etapa tem um status, aplicado aos cards que entram nela.

Objeto Etapa

Campo	Tipo	Descrição
`id`	`integer`	Identificador.
`name`	`string`	Nome da coluna.
`color`	`string`	Cor em hexadecimal, como `#FF0000`.
`sequence`	`integer`	Ordem da coluna. `0` é a primeira.
`status`	`string`	Status aplicado aos cards que entram na etapa. Padrão `progress`.
`config`	`object \| null`	Configurações da etapa. Veja Follow-up automático.
`tasks`	`array`	Cards da etapa. Só em Obter pipeline.

Etapas padrão

Se você adicionar um card a uma pipeline sem etapas, o Hust cria três automaticamente:

Etapa	Status
A fazer	`pending`
Fazendo	`progress`
Concluído	`finished`

Criar etapa

POST /task/stage

Campo	Tipo	Obrigatório	Descrição
`name`	`string`	Sim	Nome.
`color`	`string`	Sim	Cor hexadecimal.
`pipelineId`	`integer`	Sim	Pipeline de destino.

A etapa entra no fim da pipeline, com status progress.

curl -X POST https://api.hustapp.com/task/stage \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Proposta enviada", "color": "#FF9800", "pipelineId": 1 }'

Resposta

{ "id": 13, "name": "Proposta enviada", "color": "#FF9800", "sequence": 3, "pipelineId": 1 }

Editar etapa

PUT /task/stage/{id}

Somente gestor.

Campo	Tipo	Obrigatório	Descrição
`name`	`string`	Sim	Nome.
`color`	`string`	Sim	Cor hexadecimal.

curl -X PUT https://api.hustapp.com/task/stage/13 \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Negociação", "color": "#9C27B0" }'

Status	Corpo
`200`	A etapa atualizada.
`400`	`{ "message": "MISSING_REQUIRED_FIELDS" }` ou mensagem de permissão.
`404`	`{ "message": "STAGE_NOT_FOUND" }`

Configurar etapa

PUT /task/stage/{id}/config

Atualiza o config da etapa. Hoje a única configuração é o follow-up automático. Retorna 200 com true.

Excluir etapa

DELETE /task/stage/{id}

Mova os cards da etapa antes de excluí-la.

Status	Corpo
`200`	`{ "message": "Stage excluída com sucesso" }`
`404`	`{ "message": "STAGE_NOT_FOUND" }`

Reordenar etapas

A ordem das colunas é alterada pela pipeline. Veja Reordenar etapas.

Começando

Funis

Cards

Objeto Etapa

Etapas padrão

Criar etapa

Editar etapa

Configurar etapa

Excluir etapa

Reordenar etapas

​Objeto Etapa

​Etapas padrão

​Criar etapa

​Editar etapa

​Configurar etapa

​Excluir etapa

​Reordenar etapas

Objeto Etapa

Etapas padrão

Criar etapa

Editar etapa

Configurar etapa

Excluir etapa

Reordenar etapas