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.

Path Params
string
enum
required

Uma das seguintes: leads|contatos|empresas

Allowed:
Body Params
RAW_BODY
array of objects
RAW_BODY
Responses

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json