Référence de l'APIPATCH

Mettre à jour le statut de mention

Approuve, rejette ou réinitialise une mention pour que la file de relecture reflète le travail déjà traité.

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

Approuve, rejette ou réinitialise une mention pour que la file de relecture reflète le travail déjà traité.

Jeton Bearer (jeton API RedReplier)

Authentification

Envoyez un token API RedReplier comme Bearer token à chaque requête. Les tokens commencent par redreplier_; RedReplier résout le compte depuis le token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Paramètres

  • mentionId (chemin, UUID, requis): Mention à mettre à jour.

Corps de la requête

  • status (string, requis): Nouveau statut: NEW, APPROVED ou REJECTED.

Réponse

Renvoie un objet Mention public.

  • id (string): UUID de la mention.
  • websiteId (string | null): UUID du site web.
  • source (string): REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY ou HACKERNEWS.
  • keyword (string | null): Valeur de mot-clé qui a correspondu.
  • title, contentText, url, author, subreddit (string | null): Contexte du titre, du contenu et du lien. subreddit n’est renseigné que pour les sources Reddit et vaut null pour X, Bluesky et Hacker News.
  • status (string): NEW, APPROVED ou REJECTED.
  • relevanceScore (number | null): Score de pertinence IA de 0 à 100, ou null.
  • relevanceReason (string | null): Explication IA de la correspondance, ou null.
  • tags (string[]): Tags de pertinence générés par IA.
  • publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt (ISO string | null): Horodatages de publication, d’ingestion, de revue, de création et de mise à jour au format ISO 8601, ou null.

Exemple de requête

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"}'

Notes

Le tri est réversible. Les mentions REJECTED sont exclues des listes par défaut.

Erreurs

  • 400 Bad Request: Entrée, URL, UUID, enum, paramètre de requête ou corps non valide.
  • 401 Unauthorized: Bearer token manquant ou non valide.
  • 404 Not Found: La ressource n’existe pas pour le compte du token.
  • 500 Internal Server Error: Erreur serveur inattendue.
Exemple de requête (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.",
  "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"
}