Referencia de APIPOST

Desactivar palabra clave

Pausa el monitoreo de una sola palabra clave sin eliminarla, para poder activarla de nuevo más adelante.

POSThttps://ai.redreplier.com/ai-app/api/v1/keywords/{keywordId}/disable

Pausa el monitoreo de una sola palabra clave sin eliminarla, para poder activarla de nuevo más adelante.

Token Bearer (token de API de RedReplier)

Parámetros

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

Cuerpo de la solicitud

Este endpoint no requiere un cuerpo JSON.

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

Desactivar detiene el monitoreo inmediatamente y no consume el cupo de edición. Desactivar una palabra clave activa libera su plaza en el plan, así que la palabra clave pendiente más antigua que quepa pasa a activa y empieza a monitorizarse.

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.
Solicitud de ejemplo (curl)
curl --request POST \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d/disable \
  --header 'Authorization: Bearer redreplier_test_1234567890'
201
{
  "id": "73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d",
  "websiteId": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
  "value": "agency CRM",
  "status": "DISABLED",
  "createdAt": "2026-05-22T10:16:00.000Z",
  "updatedAt": "2026-05-29T14:02:11.000Z"
}