Skip to main content
PATCH
Update a contact tag
Cambia el nombre de la etiqueta identificada por tagId. levios también actualiza el nombre de la etiqueta en sus asignaciones de contactos actuales. Tu clave de API necesita el permiso contacts:write. La etiqueta y account_id deben pertenecer a una cuenta de Instagram a la que pueda acceder la clave.

Cuerpo de la solicitud

Envía exactamente estos campos:
  • account_id: el UUID de la cuenta de Instagram.
  • name: el nombre nuevo de la etiqueta.
levios elimina los espacios de los extremos de name y reduce los espacios consecutivos a uno. El nombre normalizado debe tener entre 1 y 50 caracteres. La entrada sin procesar puede tener hasta 200 caracteres, y el resultado normalizado no puede contener caracteres de control.

Restricciones para cambiar el nombre

La API devuelve api_contact_tag_conflict cuando otra etiqueta ya usa el nombre normalizado. Devuelve api_contact_tag_in_use cuando la configuración de una automatización hace referencia al nombre actual. Actualiza esas configuraciones de automatización antes de cambiar el nombre de la etiqueta. Enviar el nombre normalizado actual de la etiqueta no la modifica y devuelve la etiqueta actual. La operación es idempotente.
Si la API devuelve api_contact_tag_response_unavailable con committed: true y retryable: false, la etiqueta cambió, pero no se pudo verificar la respuesta. No reintentes la operación automáticamente. Consulta el catálogo de etiquetas actual antes de decidir si envías otra solicitud.

Autorizaciones

Authorization
string
header
requerido

Levios API key sent as a Bearer token.

Parámetros de ruta

tagId
string<uuid>
requerido

Cuerpo

application/json
account_id
string<uuid>
requerido
name
any
requerido

Respuesta

Successful response.