Referência da APIPATCH

Atualizar status da menção

Aprova, rejeita ou redefine uma menção.

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

Aprova, 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/json

Parâmetros

  • mentionId (caminho, UUID, obrigatório): Menção a ser atualizada.

Corpo da requisição

  • status (string, obrigatório): Novo status: NEW, APPROVED ou REJECTED.

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), BLUESKY ou HACKERNEWS.
  • 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 é null para X, Bluesky e Hacker News.
  • status (string): NEW, APPROVED ou REJECTED.
  • relevanceScore (number | null): Pontuação de relevância de IA de 0 a 100, ou null.
  • relevanceReason (string | null): Explicação de IA para a correspondência, ou null.
  • 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, ou null.

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