patch https://{subdomain}.kommo.com/api/v4/
Este método permite atualizar várias entidades. Um array de objetos de entidade é passado.
Limitações
O método está disponível de acordo com os direitos do usuário.
Parâmetros de solicitação
É importante observar que todas as tags da entidade devem ser passadas. Se as tags já anexadas não forem passadas, elas serão desanexadas da entidade.
Parâmetro | Tipo de dado | Descrição |
---|---|---|
id | int | ID de entidade |
_embedded[tags] | array|null | Dados das tags adicionadas. Passe ‘null’ para desanexar tags de uma entidade. |
_embedded[tags][0] | object | Modelo de tag. É necessário o parâmetro "id" ou "name". |
_embedded[tags][0][id] | int | ID da tag |
_embedded[tags][0][name] | string | Nome da tag |
Exemplo de solicitação
No exemplo a seguir, atualizaremos as tags de 2 leads usando o método /api/v4/leads.
[
{
"id": 167353,
"_embedded": {
"tags": [
{
"id": 263807
}
]
}
},
{
"id": 167355,
"_embedded": {
"tags": null
}
}
]
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 array de entidades atualizadas.