patch
https://{subdominio}.kommo.com/api/v4/leads/pipelines//statuses/
Este método permite editar una etapa del pipeline. Puedes pasar descripciones de la etapa (opcional).
Limitaciones
El método está disponible solo para usuarios administradores.
Las siguientes restricciones se aplican a las descripciones de etapas:
- Solo se pueden crear 3 descripciones de etapas para diferentes niveles de usuario.
- No puedes asignar el mismo nivel en diferentes descripciones.
- La longitud máxima de la descripción es de 1000 caracteres.
- Puedes enviar emojis en las descripciones.
- Puedes asignar los siguientes niveles en las descripciones: principiante, candidato y maestro.
Tipo de autorización
OAuth 2.0 con Token de acceso/ Token de larga duración.
Encabezado de tipo de datos cuando la solicitud es exitosa
Content-Type: application/hal+json.
Encabezado de tipo de datos en caso de un error
Content-Type: application/problem+json.
Parámetros de respuesta
El método retorna un objeto de la etapa editada.
| Parámetro | Tipo de dato | Descripción |
|---|---|---|
| name | string | Nombre de la etapa |
| sort | int | Número de secuencia de la etapa en el pipeline |
| color | string | Color de la etapa |
| request_id | string | El campo será retornado sin cambios en la respuesta y no se guardará. |
| descriptions | array | Arreglo de descripciones de la etapa |
| descriptions[0] | object | Objeto de descripción de la etapa |
| descriptions[0][level] | string | Nivel de los usuarios para los cuales se crea la descripción |
| descriptions[0][description] | string | Descripción de la etapa |