Trabajar con entornos ahora es más fácil. Esta actualización de la API de Kinsta introduce nuevas formas de obtener datos de la estructura de archivos, realizar envíos selectivos de archivos entre entornos y recuperar todos los entornos en una única solicitud al listar los sitios.

Estas nuevas funciones están diseñadas para reducir el número de llamadas que debes realizar, de modo que tus despliegues y herramientas de desarrollo sean más rápidos y eficientes.

Obtener la lista de archivos de un entorno

Ahora puedes recuperar la estructura completa de directorios de un entorno de WordPress utilizando la API de Kinsta. Este nuevo endpoint devuelve una lista recursiva de carpetas y subcarpetas, ofreciéndote una visión clara de lo que hay dentro de cada entorno — sin necesidad de iniciar sesión SSH.

Esto es especialmente útil para construir herramientas internas, validar rutas de archivos antes de despliegues selectivos o automatizar tareas de entorno con precisión.

Puedes enviar una solicitud a GET:

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

Aquí tienes un ejemplo de solicitud utilizando curl:

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

La respuesta incluye objetos anidados que representan directorios como:

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

Cada carpeta contiene su nombre, ruta y cualquier hijo, lo que facilita su mapeo o visualización.

Envío selectivo de archivos entre entornos

El endpoint Push Environment existente ahora soporta una forma más flexible de gestionar las transferencias de archivos. Con dos nuevos campos opcionales, puedes enviar todo el entorno o solo directorios específicos — lo que resulta perfecto para flujos de trabajo en los que no deseas sincronizar todo.

Puedes enviar una solicitud a PUT:

PUT /sites/{site_id}/environments

Utiliza los siguientes campos para controlar qué archivos se incluyen:

  • push_files_option: Elige entre "ALL_FILES" o "SPECIFIC_FILES"
  • file_list: Proporciona una lista de rutas de directorios que quieras insertar

Aquí tienes un ejemplo en el que se utiliza curl para transferir sólo las carpetas seleccionadas de un entorno a otro:

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"
    ]
  }'

Este enfoque selectivo ayuda a:

  • Reducir el tiempo de despliegue sincronizando sólo lo que ha cambiado
  • Evitar sobrescribir otros activos o cargas
  • Mejorar el control al pasar los cambios del entorno staging al de producción.

Si no incluyes push_files_option, se utiliza por defecto "ALL_FILES", manteniendo la compatibilidad con versiones anteriores.

Lista los sitios y sus entornos en una sola llamada

Ahora puedes obtener todos los sitios de una empresa y sus entornos con una sola llamada a la API. Si añades el parámetro de consulta include_environments=true al endpoint GET /sites, la respuesta incluirá los entornos asociados a cada centro, sin necesidad de realizar solicitudes de seguimiento por separado.

Esto es especialmente útil para agencias o equipos que gestionan un gran número de sitios, donde minimizar las llamadas a la API y acelerar las auditorías de entornos puede suponer una gran diferencia.

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

Aquí tienes un ejemplo de solicitud a curl:

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

La respuesta incluye metadatos del sitio (nombre, ID, etc.) y una lista anidada de entornos (staging, production, etc.).

API de Kinsta: diseñada para equipos que gestionan a gran escala

Estas mejoras de la API están diseñadas para ahorrar tiempo y reducir la complejidad, especialmente para desarrolladores y agencias que gestionan docenas (o cientos) de sitios de WordPress.

Tanto si estás sincronizando archivos de plugins seleccionados, creando herramientas internas o auditando entornos en un portfolio, estas mejoras te ayudan a optimizar el trabajo que, de otro modo, tendrías que hacer manualmente en el panel de control.

Puedes explorar estas nuevas capacidades en la documentación de la API de Kinsta o acceder directamente a MyKinsta para generar tu token de acceso y empezar a construir.