Añadir etiquetas a entidades

Este método permite actualizar múltiples entidades. Se pasa un arreglo de objetos entidad.

Limitaciones
El método está disponible de acuerdo con los permisos del usuario.

Parámetros de respuesta

Es importante tener en cuenta que se deben pasar todas las etiquetas de la entidad; si no se incluyen las etiquetas ya adjuntas, se desvincularán de la entidad.

ParámetroTipo de datoDescripción
idintID de la entidad.
  • embedded[tags]
array|nullDatos de las etiquetas añadidas.
  • *Puedes pasar 'null' para desvincular las etiquetas de una entidad.**.
  • embedded[tags][0]
objectModelo de etiqueta. Se requiere el parámetro "id" o "name".
  • embedded[tags][0][id]
intID de la etiqueta.
  • embedded[tags][0][name]
stringNombre de la etiqueta.

Un ejemplo de la solicitud
En el siguiente ejemplo actualizaremos las etiquetas de 2 leads utilizando el método /api/v4/leads.

[
    {
        "id": 167353,
        "_embedded": {
            "tags": [
                {
                    "id": 263807
                }
            ]
        }
    },
    {
        "id": 167355,
        "_embedded": {
            "tags": null
        }
    }
]

Encabezado de tipo de datos cuando la solicitud es exitosa
Content-Type: application/hal+json.

Encabezado de tipo de datos en caso de un error
Content-Type: application/problem+json.

Parámetros de respuesta
El método retorna un arreglo de entidades actualizadas.

Path Params
string
enum
required

Uno de estos: leads | contactos | compañías

Allowed:
Body Params
RAW_BODY
array of objects
RAW_BODY
Headers
string
Defaults to application/json
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