Desativar palavra-chave

Parâmetros

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

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

Desativar interrompe o monitoramento imediatamente e não consome a cota de edição. Desativar uma palavra-chave ativa libera a vaga dela no plano, então a palavra-chave pendente mais antiga que caiba fica ativa e começa a ser monitorada.

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.