Referencia de APIPATCH

Actualizar estado de mención

Aprueba, rechaza o restablece una mención para que la cola de revisión refleje lo que tu equipo ya gestionó.

PATCHhttps://ai.redreplier.com/ai-app/api/v1/mentions/{mentionId}/status

Aprueba, rechaza o restablece una mención para que la cola de revisión refleje lo que tu equipo ya gestionó.

Token Bearer (token de API de RedReplier)

Parámetros

  • mentionId (ruta, UUID, obligatorio): Mención que se actualizará.

Cuerpo de la solicitud

  • status (string, obligatorio): Nuevo estado: NEW, APPROVED o REJECTED.

Respuesta

Devuelve un objeto Mention público.

  • id (string): UUID de la mención.
  • websiteId (string | null): UUID del sitio web.
  • source (string): REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS, FACEBOOK o FACEBOOK_GROUP.
  • keyword (string | null): Valor de palabra clave que coincidió.
  • title, contentText, url, author, subreddit (string | null): Contexto de título, cuerpo y enlace. subreddit contiene el subreddit en fuentes de Reddit y el id del grupo en FACEBOOK_GROUP, y es null en las demás fuentes.
  • status (string): NEW, APPROVED o REJECTED.
  • relevanceScore (number | null): Puntuación de relevancia de IA de 0 a 100, o null.
  • relevanceReason (string | null): Explicación de IA de la coincidencia, o null.
  • aiReplySuggestion (string | null): Respuesta redactada por IA para que una persona la revise antes de publicarla, o null.
  • tags (string[]): Etiquetas de relevancia generadas por IA.
  • publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt (ISO string | null): Marcas de publicación, ingesta, revisión, creación y actualización en formato ISO 8601, o null.

Notas

La clasificación es reversible. Las menciones REJECTED se excluyen de los listados por defecto.

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 PATCH \
  --url https://ai.redreplier.com/ai-app/api/v1/mentions/6a9f0e8b-2c65-44f7-b6e6-7f88a7df8301/status \
  --header 'Authorization: Bearer redreplier_test_1234567890' \
  --header 'Content-Type: application/json' \
  --data '{"status": "APPROVED"}'
200
{
  "id": "6a9f0e8b-2c65-44f7-b6e6-7f88a7df8301",
  "websiteId": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
  "source": "REDDIT_POST",
  "keyword": "agency CRM",
  "title": "Best CRM for a small agency?",
  "contentText": "We need a lightweight CRM for client follow-ups and deal tracking.",
  "url": "https://reddit.com/r/sales/comments/example/best_crm_for_a_small_agency",
  "author": "agency_ops",
  "subreddit": "sales",
  "status": "APPROVED",
  "relevanceScore": 86,
  "relevanceReason": "The thread asks for an agency CRM, which directly matches the monitored product category.",
  "aiReplySuggestion": "We built Acme CRM for small agencies with exactly this problem. Happy to share how teams set up follow-up reminders.",
  "tags": ["recommendation-request", "high-intent"],
  "publishedAt": "2026-05-29T09:20:00.000Z",
  "ingestedAt": "2026-05-29T09:24:12.000Z",
  "reviewedAt": "2026-05-29T10:15:00.000Z",
  "createdAt": "2026-05-29T09:24:12.000Z",
  "updatedAt": "2026-05-29T09:24:12.000Z"
}