Atualizando tags

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âmetroTipo de dadoDescrição
idintID de entidade
_embedded[tags]array|nullDados das tags adicionadas.
Passe ‘null’ para desanexar tags de uma entidade.
_embedded[tags][0]objectModelo de tag. É necessário o parâmetro "id" ou "name".
_embedded[tags][0][id]intID da tag
_embedded[tags][0][name]stringNome 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.

Language
Credentials
OAuth2
URL
Click Try It! to start a request and see the response here!