Referencia de APIDEL

Eliminar palabra clave

Elimina permanentemente una palabra clave en cualquier estado, junto con todas las menciones que produjo.

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

Elimina permanentemente una palabra clave en cualquier estado, junto con todas las menciones que produjo.

Token Bearer (token de API de RedReplier)

Parámetros

  • keywordId (ruta, UUID, obligatorio): Palabra clave que se eliminará, en cualquier estado.

Cuerpo de la solicitud

Este endpoint no requiere un cuerpo JSON.

Respuesta

Devuelve una confirmación de eliminación.

  • deleted (boolean): Siempre true cuando la eliminación se completa correctamente.

Notas

Permanente: se eliminan la palabra clave y todas las menciones que produjo, sea cual sea su estado. Eliminar una palabra clave activa libera su plaza en el plan, y la palabra clave pendiente más antigua que quepa pasa a activa y empieza a monitorizarse. Para dejar de monitorizar y conservar las menciones, usa Desactivar palabra clave.

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 DELETE \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "deleted": true
}