> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hustapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Etapas

> Crie, edite e exclua as colunas de uma pipeline

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](/crm/visao-geral.md#status) aplicado aos cards que entram na etapa. Padrão `progress`. |
| `config` | `object \| null` | Configurações da etapa. Veja [Follow-up automático](/crm/follow-up.md). |
| `tasks` | `array` | Cards da etapa. Só em [Obter pipeline](/crm/pipelines.md#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

```http theme={null}
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`.

```bash theme={null}
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 }'
```

```json Resposta theme={null}
{ "id": 13, "name": "Proposta enviada", "color": "#FF9800", "sequence": 3, "pipelineId": 1 }
```

## Editar etapa

```http theme={null}
PUT /task/stage/{id}
```

**Somente gestor.**

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

```bash theme={null}
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

```http theme={null}
PUT /task/stage/{id}/config
```

Atualiza o `config` da etapa. Hoje a única configuração é o [follow-up automático](/crm/follow-up.md). Retorna `200` com `true`.

## Excluir etapa

```http theme={null}
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](/crm/pipelines.md#reordenar-etapas).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.