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â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.

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