Actualizar estado de mención

Autenticación

Envía un token de API de RedReplier como Bearer token en cada solicitud. Los tokens empiezan por redreplier_; RedReplier resuelve la cuenta desde el token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

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 o HACKERNEWS.
• keyword (string | null): Valor de palabra clave que coincidió.
• title, contentText, url, author, subreddit (string | null): Contexto de título, cuerpo y enlace. subreddit solo se rellena para fuentes de Reddit y es null para X, Bluesky y Hacker News.
• 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.
• 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.

Solicitud de ejemplo

curl -X PATCH https://ai.redreplier.com/ai-app/api/v1/mentions/33333333-3333-4333-8333-333333333333/status \
  -H 'Authorization: Bearer redreplier_test_1234567890' \
  -H 'Content-Type: application/json' \
  -d '{"status":"APPROVED"}'

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.
• 404 Not Found: El recurso no existe para la cuenta del token.
• 500 Internal Server Error: Error inesperado del servidor.