Hemos lanzado un nuevo conjunto de endpoints de la API y mejoras centradas en proporcionar a los desarrolladores de WordPress más control sobre las operaciones del sitio, la configuración DNS y los ajustes de recursos.

Ahora puedes automatizar tareas que van desde el restablecimiento de sitios de WordPress hasta la gestión de registros de verificación de dominios y entradas DNS, especialmente a gran escala.

Estas son las novedades:

Restablecer un sitio

Al igual que con el panel de control de MyKinsta, ahora puedes restablecer un sitio de WordPress utilizando el nuevo endpoint de la API /reset-site. Esta acción restablece el sistema de archivos y la base de datos del sitio, restaurándolo a una instalación limpia de WordPress.

Esto es ideal para configuraciones con scripts, plantillas de aprovisionamiento o para empezar de cero rápidamente durante el desarrollo.

Para utilizarla, envía una solicitud POST con el ID del sitio y tu contraseña de administrador:

curl -i -X POST \
  'https://api.kinsta.com/v2/sites/{site_id}/reset-site' \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "admin_password": "your-admin-password"
  }'

Obtener los registros de verificación y direccionamiento de un dominio

También hemos introducido el endpoint /verification-records que te permite obtener los registros de verificación y direccionamiento de cualquier dominio conectado a un entorno de WordPress.

Esto es útil para configurar dominios personalizados y confirmar que apuntan correctamente. También es útil si quieres automatizar la verificación de dominios como parte de flujos de trabajo CI/CD o de aprovisionamiento.

Aquí tienes un ejemplo de solicitud:

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/domains/{site_domain_id}/verification-records' \
  -H 'Authorization: Bearer '

La respuesta proporciona registros DNS, como CNAME o TXT, necesarios para la validación del dominio y la configuración de la red edge:

{
  "site_domain": {
    "verification_records": [
      {
        "name": "_acme-challenge.staging.example-site.io",
        "value": "staging.example-site.io.kinstavalidation.app",
        "type": "CNAME"
      }
    ],
    "pointing_records": [
      {
        "name": "staging.example-site.io",
        "value": "192.0.2.10",
        "type": "A"
      },
      {
        "name": "www",
        "value": "staging.example-site.io",
        "type": "CNAME"
      }
    ]
  }
}

Gestionar registros DNS mediante programación

Ahora puedes gestionar dominios y registros DNS mediante programación utilizando la API de Kinsta (similar a la funcionalidad disponible en MyKinsta en DNS de Kinsta).

Esto incluye:

Esta API refleja lo que puedes hacer en MyKinsta al gestionar zonas vinculadas al DNS de Kinsta, impulsado por Amazon Route53.

Por ejemplo. Supongamos que quieres añadir un registro A para un subdominio:

curl -X POST \
  'https://api.kinsta.com/v2/domains/{domain_id}/dns-records' \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "A",
    "name": "staging.mydomain.com",
    "ttl": 3600,
    "resource_records": [
      { "value": "1.1.1.1" }
    ]
  }'

Esto es útil cuando se aprovisionan dominios dinámicamente o se sincronizan cambios DNS desde su pipeline CI/CD, especialmente para agencias multisitio o flujos de trabajo con muchos entornos de prueba (staging).

Para conocer los tipos de registro soportados y el comportamiento de DNS, consulta la documentación de DNS de Kinsta.

Establecer la asignación de hilos PHP

El add-on de rendimiento PHP es uno de los más utilizados en Kinsta, ya que ayuda a los sitios a manejar más tráfico y procesamiento pesado sin sudar.

Tenía sentido incorporar ese control a la API, por lo que a principios de este año introdujimos dos endpoints para gestionar el rendimiento de PHP mediante programación:

Estos endpoints aceptaban originalmente worker_number y worker_memory, pero en consonancia con nuestro cambio en toda la empresa de «PHP workers» a «hilos» (que refleja mejor cómo funciona realmente PHP), hemos dejado obsoletos esos antiguos campos.

Campos PHP obsoletos
Campos obsoletos.

A finales de agosto de 2025, sólo se admitirán thread_count y thread_memory. Si ya utilizas estos endpoints, ahora es el momento de actualizar tus solicitudes.

Este es el aspecto de una solicitud de configuración de hilos utilizando los campos actualizados:

curl -i -X POST \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/change-environment-php-allocation' \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "thread_count": 2,
    "thread_memory": 256
  }'

Lo anterior establece dos hilos PHP para ese entorno, cada uno con 256MB de memoria. Esto coincide con el mismo control que encuentras en MyKinsta.

Los listados de entornos muestran ahora la versión de WordPress

Cuando se gestionan varios sitios, es útil saber exactamente qué versión de WordPress está ejecutando cada entorno, especialmente si tu equipo tiene diferentes calendarios de actualización entre clientes o etapas.

Hemos añadido un nuevo campo wordpress_version a estos endpoints:

Ahora, cuando obtienes datos del entorno, se incluye la versión de WordPress. Esto facilita la detección de instalaciones obsoletas o la confirmación de que las actualizaciones se han aplicado correctamente sin necesidad de acceder manualmente a cada sitio.

Aquí tienes un ejemplo del aspecto de la respuesta:

{
  "site": {
    "environments": [
      {
        "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
        "name": "live",
        "display_name": "Live",
        "wordpress_version": "6.3.1",
        "is_premium": false,
        "is_additional_sftp_accounts_enabled": false,
        ...
      }
    ]
  }
}

Obtener una lista de regiones disponibles

Supongamos que necesitas crear nuevos entornos en una ubicación concreta. Con el nuevo /available-regions ahora puedes recuperar la lista de regiones disponibles vinculadas a tu empresa.

Esto le ayuda a confirmar mediante programación qué ubicaciones de centros de datos están disponibles para despliegues y resulta útil si gestiona varios clientes o realiza escalados en diferentes regiones.

Aquí tienes un ejemplo de respuesta:

{
  "company": {
    "available_regions": [
      {
        "name": "Dallas US (us-south1)",
        "region": "us-south1"
      }
    ]
  }
}

Más flexibilidad para tus flujos de trabajo

Este lote de actualizaciones te ofrece más control programático sobre entornos, dominios, registros DNS, rendimiento PHP y los despliegues regionales.

Tanto si estás ajustando hilos y memoria, gestionando dominios a escala o sincronizando versiones de WordPress entre sitios, la API de Kinsta sigue creciendo pensando en los equipos modernos.

¿Necesitas pruebas de que es escalable? Recientemente hemos publicado un caso práctico sobre cómo Sod gestiona más de 400 sitios con automatización personalizada basada en la API de Kinsta.