patch https://{subdominio}.kommo.com/api/v4/
Este método permite actualizar múltiples entidades. Se pasa un arreglo de objetos entidad.
Limitaciones
El método está disponible de acuerdo con los permisos del usuario.
Parámetros de respuesta
Es importante tener en cuenta que se deben pasar todas las etiquetas de la entidad; si no se incluyen las etiquetas ya adjuntas, se desvincularán de la entidad.
Parámetro | Tipo de dato | Descripción |
---|---|---|
id | int | ID de la entidad. |
_embedded[tags] | array|null | Datos de las etiquetas añadidas. Puedes pasar 'null' para desvincular las etiquetas de una entidad.. |
_embedded[tags][0] | object | Modelo de etiqueta. Se requiere el parámetro "id" o "name". |
_embedded[tags][0][id] | int | ID de la etiqueta. |
_embedded[tags][0][name] | string | Nombre de la etiqueta. |
Un ejemplo de la solicitud
En el siguiente ejemplo actualizaremos las etiquetas de 2 leads utilizando el método /api/v4/leads.
[
{
"id": 167353,
"_embedded": {
"tags": [
{
"id": 263807
}
]
}
},
{
"id": 167355,
"_embedded": {
"tags": null
}
}
]
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 arreglo de entidades actualizadas.