patch https://{subdomain}.kommo.com/api/v4/leads/pipelines//statuses/
Este método permite editar uma etapa do pipeline. Você pode passar descrições de etapas (opcionalmente).
Limitações
O método é disponível apenas para usuários administradores.
As seguintes restrições se aplicam às descrições das etapas:
- Apenas 3 descrições de etapas podem ser criadas para diferentes níveis de usuário.
- Não é permitido passar o mesmo nível para descrições diferentes.
- O comprimento máximo da descrição é de 1000 caracteres.
- Emojis podem ser incluídos nas descrições.
- Os seguintes níveis podem ser utilizados nas descrições: newbie, candidate e master.
Tipo de autorização
OAuth 2.0 com Token de Acesso / Token de Longa Duração
Cabeçalho de tipo de dado quando a solicitação é bem-sucedida
Content-Type: application/hal+json
Cabeçalho de tipo de dado em caso de erro
Content-Type: application/problem+json
Parâmetros de resposta
O método retorna um objeto da Etapa editada.
| Parâmetro | Tipo de dado | Descrição |
|---|---|---|
| name | string | Nome da Etapa |
| sort | int | Número de sequência da etapa no pipeline |
| color | string | Cor da Etapa |
| request_id | string | O campo será retornado inalterado na resposta e não será salvo. |
| descriptions | array | Array das descrições de Etapa |
| descriptions[0] | object | Objeto da descrição da Etapa |
| descriptions[0][level] | string | Nível de usuários para os quais a descrição é criada. |
| descriptions[0][description] | string | Descrição da Etapa |