Editar palabra clave

Parámetros

• keywordId (ruta, UUID, obligatorio): Palabra clave que se editará.

Cuerpo de la solicitud

• value (string, obligatorio, máximo 255): Nuevo texto de la palabra clave.

Respuesta

Devuelve un objeto Keyword público.

• id (string): UUID de la palabra clave.
• websiteId (string): UUID del sitio web principal.
• value (string): Texto de la palabra clave, hasta 255 caracteres.
• status (string): PENDING, ACTIVE, DISABLED o SUSPENDED.
• createdAt, updatedAt (ISO string | null): Marcas de creación y actualización en formato ISO 8601, o null.

Notas

Las ediciones son ilimitadas y conservan la plaza pagada que ya tiene la palabra clave: una palabra clave ACTIVE sigue ACTIVE, y cualquier otra pasa a ACTIVE si el plan tiene una plaza libre; si no, a PENDING. Un cambio que solo altera mayúsculas y minúsculas no hace nada, y un valor que duplica otra palabra clave del mismo sitio web devuelve 400. Editar una palabra clave SUSPENDED es la forma normal de corregir términos ruidosos.

Errores

• 400 Bad Request: Entrada, URL, UUID, enum, parámetro de consulta o cuerpo no válido.
• 401 Unauthorized: Bearer token ausente o no válido, o code: "token_issuer_lost_access" cuando la persona que creó la clave API fue desactivada o salió del workspace.
• 403 Forbidden: code: "subscription_required" cuando el plan del workspace no incluye acceso a la API, code: "workspace_access_denied" cuando X-Workspace-Id indica un workspace al que esta credencial no puede acceder, o code: "permission_denied" cuando tu rol en el workspace no tiene el permiso redreplier.write (lo tienen Admin y Editor).
• 404 Not Found: El recurso no existe para la cuenta del token.
• 429 Too Many Requests: Límite de solicitudes superado. Espera los segundos indicados en Retry-After.
• 500 Internal Server Error: Error inesperado del servidor.