Várias tarefas que antes exigiam acessar o MyKinsta agora podem ser realizadas por meio da API da Kinsta.

Você pode escolher como um novo domínio será configurado, gerenciar a opção Forçar HTTPS, executar uma operação de pesquisar e substituir em um banco de dados, filtrar os registros do site por um período específico e verificar se um backup para download está disponível antes de solicitá-lo.

Adicione domínios com mais controle

O endpoint existente para adicionar um novo domínio ao site agora oferece suporte a dois campos opcionais: add_with_www_subdomain e setup_type.

Use add_with_www_subdomain para adicionar a versão www de um domínio na mesma solicitação que o domínio raiz. Esse campo não pode ser habilitado quando is_wildcardless estiver definido como true.

O campo setup_type permite escolher entre:

  • quick, que é o método de configuração padrão.
  • avoid_downtime, para fluxos de trabalho em que o domínio precisa ser preparado antes que o tráfego seja redirecionado.

Por exemplo, a solicitação a seguir adiciona example.com e seu subdomínio www usando a opção de configuração desenvolvida para evitar tempo de inatividade:

curl --request POST \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/domains \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "domain_name": "example.com",
    "is_wildcardless": false,
    "add_with_www_subdomain": true,
    "setup_type": "avoid_downtime"
  }'

Quando a solicitação é aceita, a API retorna uma resposta 202 com um ID de operação que você pode usar para acompanhar o progresso:

{
  "operation_id": "sites:add-domain-54fb80af-576c-4fdc-ba4f-b596c83f15a1",
  "message": "Adding site domain in progress",
  "status": 202
}

Você pode encontrar todos os campos compatíveis e os detalhes da resposta na documentação da API.

Verifique e altere a opção Forçar HTTPS

Dois novos endpoints fornecem acesso programático à ferramenta Forçar HTTPS da Kinsta. Você pode consultar a configuração atual de um ambiente e atualizá-la sem precisar abrir o MyKinsta.

Para verificar o status atual, envie uma solicitação GET:

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/force-https-status \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

A resposta retorna um destes valores:

  • ENABLED_FOR_ALL
  • ENABLED_REDIRECT_TO_PRIMARY
  • DISABLED

Por exemplo:

{
  "force_https_status": "ENABLED_REDIRECT_TO_PRIMARY"
}

Para alterar a configuração, mande uma solicitação POST com um dos valores suportados:

curl --request POST \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/force-https-status \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "ENABLED_REDIRECT_TO_PRIMARY"
  }'

A API inicia a atualização e retorna um ID de operação:

{
  "operation_id": "force-https:update-status-54fb80af-576c-4fdc-ba4f-b596c83f15a1",
  "message": "Updating Force HTTPS status in progress. Use the operation_id to check the status.",
  "status": 202
}

Isso significa que a configuração do domínio e do HTTPS agora pode fazer parte do mesmo fluxo de trabalho de provisionamento ou migração.

Execute pesquisar e substituir por meio da API

O novo endpoint de pesquisar e substituir adiciona outra ferramenta conhecida do MyKinsta à API da Kinsta.

Você pode pesquisar um valor no banco de dados do WordPress, substituir todas as correspondências e limpar o cache do site após a operação. Os cenários mais comuns incluem substituir um nome de domínio antigo após uma migração ou alterar URLs de HTTP para HTTPS.

O campo perform_replacement controla se a solicitação apenas pesquisa correspondências ou também realiza a substituição.

Veja um exemplo que substitui um nome de domínio antigo por um novo:

curl --request POST \
  --url https://api.kinsta.com/v2/sites/tools/search-and-replace \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "environment_id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "search": "old-domain.com",
    "replace": "new-domain.com",
    "perform_replacement": true,
    "is_clear_cache": true
  }'

Quando a ação é iniciada com sucesso, a resposta inclui um ID de operação:

{
  "operation_id": "environments:search-and-replace-54fb80af-576c-4fdc-ba4f-b596c83f15a1",
  "message": "Search and replace in progress",
  "status": 202
}

Assim como ocorre com a ferramenta Pesquisar e substituir do MyKinsta, a Kinsta cria um backup gerado pelo sistema antes de executar a substituição.

Pesquisar e substituir diferencia maiúsculas de minúsculas, portanto, os valores de pesquisa e substituição devem ser verificados cuidadosamente antes de enviar a solicitação.

Pesquise registros em um período específico

O endpoint para obter registros do site agora oferece suporte aos parâmetros de consulta opcionais search, from e to.

Isso permite filtrar os resultados dos registros por um período específico, em vez de recuperar um conjunto amplo de entradas recentes. Você pode aplicar os filtros ao solicitar registros de erros, registros de acesso ou registros de desempenho do cache da Kinsta.

Por exemplo, a solicitação a seguir pesquisa PHP Fatal error nos registros de erros durante um período específico:

curl --request GET \
  --url 'https://api.kinsta.com/v2/sites/environments/{env_id}/logs?file_name=error&lines=1000&search=PHP%20Fatal%20error&from=2026-07-23T00%3A00%3A00.000Z&to=2026-07-24T00%3A00%3A00.000Z' \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

As entradas de registro correspondentes são retornadas no campo logs:

{
  "environment": {
    "container_info": {
      "logs": "Matching log entries..."
    }
  }
}

Isso é útil quando você sabe aproximadamente quando um problema começou ou deseja verificar os registros relacionados a uma implantação sem precisar recuperar um grande volume de entradas não relacionadas.

A Kinsta mantém os registros do site por até quatro dias, portanto, o intervalo de datas solicitado precisa estar dentro do período de retenção disponível. Consulte mais informações na documentação da API.

Verifique quando um backup para download estará disponível

Um backup para download pode ser gerado uma vez por semana. O novo endpoint para verificar a disponibilidade do próximo backup para download agora permite verificar se outro backup está disponível antes de iniciar a ação.

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/next-downloadable-backup-available \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Se ainda não for possível criar outro backup para download, a resposta incluirá o próximo horário disponível:

{
  "is_backup_available": false,
  "reset_at": "10/10/2026, 06:16 AM UTC"
}

O endpoint existente para gerar um backup para download (downloadable-backups) também foi atualizado. Agora, ele retorna um erro quando outro backup é solicitado antes do horário de redefinição.

Quando uma solicitação é aceita, a resposta inclui um ID de operação:

curl --request POST \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/downloadable-backups \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Exemplo de resposta:

{
  "operation_id": "start-downloadable-backup-generation:update-status-54fb80af-576c-4fdc-ba4f-b596c83f15a1",
  "message": "Starting downloadable backup generation. Use the operation_id to check the status.",
  "status": 202
}

Você pode encontrar todos os detalhes na documentação da API sobre como verificar a disponibilidade de backups e criar um backup para download.

Integre mais fluxos de trabalho do MyKinsta às suas próprias ferramentas

Essas atualizações ampliam o acesso programático a vários fluxos de trabalho comuns do MyKinsta.

Em conjunto, essas adições facilitam o gerenciamento consistente de ambientes WordPress em painéis internos, scripts de provisionamento, fluxos de trabalho de implantação e outras automações criadas com a API da Kinsta.