Referência da APIPOST

Ativar palavra-chave

Retoma o monitoramento de uma palavra-chave desativada quando o plano permite.

POSThttps://ai.redreplier.com/ai-app/api/v1/keywords/{keywordId}/enable

Retoma o monitoramento de uma palavra-chave desativada quando o plano permite.

Token Bearer (token de API do RedReplier)

Parâmetros

  • keywordId (caminho, UUID, obrigatório): Palavra-chave a ser ativada.

Corpo da requisição

Este endpoint não exige um corpo JSON.

Resposta

Retorna um objeto Keyword público.

  • 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

O status retornado passa para ACTIVE se a capacidade do plano permitir; caso contrário, fica como PENDING. Nunca cobra: para ativar uma palavra-chave além do plano, faça upgrade no app do RedReplier.

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/73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d/enable \
  --header 'Authorization: Bearer redreplier_test_1234567890'
201
{
  "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"
}