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.

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