Referência da APIPATCH
Atualizar status da menção
Aprova, rejeita ou redefine uma menção.
PATCH
https://ai.redreplier.com/ai-app/api/v1/mentions/{mentionId}/statusAprova, rejeita ou redefine uma menção.
Token Bearer (token de API do RedReplier)
Autenticação
Envie um token de API do RedReplier como Bearer token em cada requisição. Os tokens começam com redreplier_; o RedReplier resolve a conta a partir do token.
Authorization: Bearer redreplier_test_1234567890
Content-Type: application/jsonParâmetros
mentionId(caminho, UUID, obrigatório): Menção a ser atualizada.
Corpo da requisição
status(string, obrigatório): Novo status:NEW,APPROVEDouREJECTED.
Resposta
Retorna um objeto Mention público.
id(string): UUID da menção.websiteId(string | null): UUID do site.source(string):REDDIT_POST,REDDIT_COMMENT,TWITTER(X),BLUESKYouHACKERNEWS.keyword(string | null): Valor de palavra-chave que correspondeu.title, contentText, url, author, subreddit(string | null): Contexto de título, conteúdo e link.subreddité preenchido apenas para fontes do Reddit e énullpara X, Bluesky e Hacker News.status(string):NEW,APPROVEDouREJECTED.relevanceScore(number | null): Pontuação de relevância de IA de0a100, ounull.relevanceReason(string | null): Explicação de IA para a correspondência, ounull.tags(string[]): Tags de relevância geradas por IA.publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt(ISO string | null): Carimbos de publicação, ingestão, revisão, criação e atualização em formato ISO 8601, ounull.
Exemplo de requisição
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
A triagem é reversível. Menções REJECTED são excluídas das listas padrão.
Erros
400 Bad Request: Entrada, URL, UUID, enum, parâmetro de consulta ou corpo inválido.401 Unauthorized: Bearer token ausente ou inválido.404 Not Found: O recurso não existe para a conta do token.500 Internal Server Error: Erro inesperado do servidor.
Exemplo de solicitação (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"
}