Referência da APIPOST

Ativar palavras-chave pendentes

Ativa palavras-chave pendentes até preencher as vagas livres do plano atual. Nunca cobra nem altera o plano.

POSThttps://ai.redreplier.com/ai-app/api/v1/keywords/activate-pending

Ativa palavras-chave pendentes até preencher as vagas livres do plano atual. Nunca cobra nem altera o plano.

Token Bearer (token de API do RedReplier)

Parâmetros

Este endpoint não aceita parâmetros de caminho nem de consulta.

Corpo da requisição

Este endpoint não exige um corpo JSON.

Resposta

Retorna todos os sites monitorados com status de palavras-chave atualizados.

  • websites (Website[]): Todos os sites monitorados após a ativação, incluindo status de palavras-chave atualizados.

Objeto Website

  • id (string): UUID do site.
  • accountGroupId (string): Grupo de conta resolvido a partir do token.
  • domain (string): Domínio normalizado do site.
  • url (string): URL do site.
  • name (string | null): Nome de exibição.
  • description (string | null): Contexto usado para pontuação de relevância.
  • createdAt, updatedAt (ISO string | null): Carimbos de criação e atualização em formato ISO 8601, ou null.
  • keywords (Keyword[]): Objetos Keyword deste site.

Objeto Keyword

  • id (string): UUID da palavra-chave.
  • websiteId (string): UUID do site principal.
  • value (string): Texto da palavra-chave, até 255 caracteres.
  • status (string): PENDING, ACTIVE, DISABLED ou SUSPENDED.
  • createdAt, updatedAt (ISO string | null): Carimbos de criação e atualização em formato ISO 8601, ou null.

Notas

Nunca cobra. Palavras-chave além do plano atual ficam PENDING até o upgrade do plano no app do RedReplier; a API não altera o plano. GET /websites executa a mesma ativação a cada chamada.

Erros

  • 400 Bad Request: Entrada, URL, UUID, enum, parâmetro de consulta ou corpo inválido.
  • 401 Unauthorized: Bearer token ausente ou inválido, ou code: "token_issuer_lost_access" quando a pessoa que criou a chave API foi desativada ou saiu do workspace.
  • 403 Forbidden: code: "subscription_required" quando o plano do workspace não inclui acesso à API, code: "workspace_access_denied" quando X-Workspace-Id indica um workspace que esta credencial não pode alcançar, ou code: "permission_denied" quando seu papel no workspace não tem a permissão redreplier.write (Admin e Editor têm).
  • 404 Not Found: O recurso não existe para a conta do token.
  • 429 Too Many Requests: Limite de requisições excedido. Aguarde os segundos indicados em Retry-After.
  • 500 Internal Server Error: Erro inesperado do servidor.
Exemplo de solicitação (curl)
curl --request POST \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/activate-pending \
  --header 'Authorization: Bearer redreplier_test_1234567890'
201
{
  "websites": [
    {
      "id": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
      "accountGroupId": "acct_7dK9pQ2",
      "domain": "acmecrm.io",
      "url": "https://acmecrm.io",
      "name": "Acme CRM",
      "description": "CRM for small agencies that need pipeline tracking and client follow-up reminders.",
      "createdAt": "2026-05-22T10:15:30.000Z",
      "updatedAt": "2026-05-29T14:02:11.000Z",
      "keywords": [
        {
          "id": "73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d",
          "websiteId": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
          "value": "agency CRM",
          "status": "ACTIVE",
          "createdAt": "2026-05-22T10:16:00.000Z",
          "updatedAt": "2026-05-29T14:02:11.000Z"
        }
      ]
    }
  ]
}