Trabalhar com ambientes ficou mais fácil. Esta atualização da API da Kinsta apresenta novas maneiras de obter dados da estrutura de arquivos, mover seletivamente os arquivos entre ambientes e recuperar todos os ambientes de um site em uma única solicitação.

Esses recursos foram projetados para reduzir o número de chamadas necessárias, acelerando seus fluxos de implantação e ferramentas de desenvolvimento.

Obtenha a lista de arquivos de um ambiente

Agora você pode recuperar a estrutura completa de diretórios de um ambiente WordPress usando a API da Kinsta. Esse novo endpoint retorna uma lista recursiva de pastas e subpastas, dando a você uma visão clara do que está dentro de cada ambiente – não são necessários logins SSH.

Isso é especialmente útil ao criar ferramentas internas, validar caminhos de arquivos antes de implementações seletivas ou automatizar tarefas de ambiente com precisão.

Você pode enviar uma solicitação GET para:

GET /sites/environments/{env_id}/file-list

Aqui está um exemplo de solicitação usando curl:

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/file-list' \
  -H 'Authorization: Bearer '

A resposta inclui objetos aninhados que representam diretórios como:

  • wp-content/
  • wp-content/plugins/
  • wp-content/themes/
  • wp-content/uploads/

Cada pasta contém seu nome, caminho e possíveis subpastas, facilitando o mapeamento ou visualização.

Mova seletivamente os arquivos entre ambientes

O endpoint Push Environment agora oferece suporte a uma maneira mais flexível de gerenciar transferências de arquivos. Com dois novos campos opcionais, você pode mover o ambiente completo ou direcionar diretórios específicos – perfeito para fluxos de trabalho em que você não deseja sincronizar tudo.

Você pode enviar uma solicitação PUT para:

PUT /sites/{site_id}/environments

Use os seguintes campos para controlar quais arquivos serão incluídos:

  • push_files_option: Escolha entre "ALL_FILES" ou "SPECIFIC_FILES"
  • file_list: Forneça uma lista de caminhos de diretório que você deseja enviar

Aqui está um exemplo que usa curl para mover apenas as pastas selecionadas de um ambiente para outro:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/{site_id}/environments' \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_env_id": "your-source-env-id",
    "target_env_id": "your-target-env-id",
    "push_db": true,
    "push_files": true,
    "run_search_and_replace": true,
    "push_files_option": "SPECIFIC_FILES",
    "file_list": [
      "wp-content/plugins",
      "wp-content/themes",
      "wp-content/uploads"
    ]
  }'

Essa abordagem seletiva ajuda você:

  • Reduz o tempo de implantação ao sincronizar apenas arquivos alterados
  • Evita sobrescrever outros ativos ou uploads
  • Melhora o controle ao migrar mudanças do ambiente de teste para produção

Se você não incluir push_files_option, o padrão será "ALL_FILES", mantendo a compatibilidade com versões anteriores.

Liste sites e seus ambientes em uma única chamada

Agora você pode buscar todos os sites de uma empresa e seus ambientes com uma única solicitação da API. Se você adicionar o parâmetro de consulta include_environments=true ao endpoint GET /sites, a resposta incluirá os ambientes associados a cada site, sem a necessidade de solicitações de acompanhamento separadas.

Ideal para agências ou equipes que gerenciam muitos sites — reduz chamadas à API e acelera auditorias de ambientes.

GET /sites?company=your-company-id&include_environments=true

Aqui está um exemplo de solicitação curl:

curl -i -X GET \
'https://api.kinsta.com/v2/sites?company=your-company-id&include_environments=true' \
  -H 'Authorization: Bearer '

A resposta inclui metadados do site (nome, ID, etc.) e uma lista aninhada de ambientes (staging, production, etc.).

API da Kinsta: Feita para equipes em escala

Essas melhorias na API foram projetadas para economizar tempo e reduzir a complexidade, especialmente para desenvolvedores e agências que gerenciam dezenas (ou centenas) de sites WordPress.

Quer você esteja sincronizando arquivos de plugins selecionados, criando ferramentas internas ou auditando ambientes em um portfólio, esses aprimoramentos ajudam a simplificar o trabalho que, de outra forma, você teria que fazer manualmente no painel.

Você pode explorar esses novos recursos na documentação da API da Kinsta ou ir direto para o MyKinsta para gerar seu token de acesso e começar a criar.