Ahora puedes hacer varias cosas mediante la API de Kinsta que antes requerían entrar en MyKinsta.

Puedes elegir cómo configurar un nuevo dominio, gestionar la opción Forzar HTTPS, ejecutar la función de buscar y reemplazar en una base de datos, filtrar los registros del sitio para un periodo de tiempo concreto y comprobar si hay una copia de seguridad descargable disponible antes de solicitarla.

Añade dominios con más control

El endpoint existente para añadir un nuevo dominio ahora soporta dos campos opcionales: add_with_www_subdomain y setup_type.

Usa add_with_www_subdomain para añadir la versión www de un dominio en la misma solicitud que el dominio raíz. Este campo no se puede activar cuando is_wildcardless está configurado en true.

El campo setup_type te permite elegir entre:

  • quick, que es el método de configuración predeterminado.
  • avoid_downtime, para flujos de trabajo en los que hay que preparar el dominio antes de redirigir el tráfico.

Por ejemplo, la siguiente solicitud añade example.com y su subdominio www utilizando la opción de configuración diseñada para evitar tiempos de inactividad:

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

Cuando se acepta la solicitud, la API devuelve una respuesta 202 con un ID de operación que puedes usar para seguir su progreso:

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

Puedes consultar todos los campos compatibles y los detalles de la respuesta en la documentación de la API.

Comprobar y cambiar Forzar HTTPS

Hay dos nuevos endpoints que te permiten acceder de forma programática a la herramienta Forzar HTTPS de Kinsta. Puedes consultar la configuración actual de un entorno y actualizarla sin tener que abrir MyKinsta.

Para comprobar el estado actual, envía una solicitud GET:

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

La respuesta devuelve uno de estos valores:

  • ENABLED_FOR_ALL
  • ENABLED_REDIRECT_TO_PRIMARY
  • DISABLED

Por ejemplo:

{
  "force_https_status": "ENABLED_REDIRECT_TO_PRIMARY"
}

Para cambiar la configuración, envía una solicitud POST con uno de los valores compatibles:

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

La API inicia la actualización y devuelve un ID de operación:

{
  "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
}

Esto significa que ahora la configuración del dominio y del HTTPS puede formar parte del mismo proceso de aprovisionamiento o migración.

Ejecuta buscar y reemplazar a través de la API

El nuevo endpoint para buscar y reemplazar incorpora otra herramienta habitual de MyKinsta a la API de Kinsta.

Puedes buscar un valor en la base de datos de WordPress, sustituir todas las coincidencias y vaciar las cachés del sitio tras la operación. Algunos casos típicos son sustituir un nombre de dominio antiguo tras una migración o cambiar las URLs de HTTP a HTTPS.

El campo perform_replacement determina si la solicitud solo busca coincidencias o si además las sustituye.

Aquí tienes un ejemplo en el que se sustituye un nombre de dominio antiguo por uno nuevo:

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

Cuando la acción se inicia con éxito, la respuesta incluye un ID de operación:

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

Al igual que con la herramienta Buscar y Reemplazar de MyKinsta, Kinsta crea una copia de seguridad generada por el sistema antes de ejecutar el reemplazo.

Buscar y Reemplazar distingue entre mayúsculas y minúsculas, así que debes comprobar bien los valores de búsqueda y reemplazo antes de enviar la solicitud.

Buscar registros dentro de un periodo específico

El endpoint get site logs ahora admite los parámetros de consulta opcionales search, from y to.

Esto te permite limitar los resultados de los registros a un periodo de tiempo concreto, en lugar de recuperar un conjunto amplio de entradas recientes. Puedes aplicar los filtros al solicitar registros de errores, registros de acceso o registros de rendimiento de la caché de Kinsta.

Por ejemplo, la siguiente solicitud busca en los registros de errores la entrada PHP Fatal error dentro de un periodo 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>'

Las entradas de registro que coinciden aparecen en el campo logs:

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

Esto te viene bien cuando sabes más o menos cuándo empezó un problema o quieres revisar los registros relacionados con un despliegue sin tener que descargar un montón de entradas que no tienen nada que ver.

Kinsta conserva los registros del sitio durante un máximo de cuatro días, por lo que el intervalo de fechas solicitado debe estar dentro del periodo de retención disponible. Consulta más información en la documentación de la API.

Comprueba cuándo hay una copia de seguridad descargable disponible

Se puede generar una copia de seguridad descargable una vez a la semana. Este nuevo endpoint next-downloadable-backup-available ahora te permite comprobar si hay otra disponible antes de iniciar la acción.

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

Si aún no se puede crear otra copia de seguridad descargable, la respuesta incluye la próxima hora disponible:

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

El endpoint existente para generar una copia de seguridad descargable (downloadable-backups) también se ha actualizado. Ahora devuelve un error si se solicita otra copia de seguridad antes de la hora de reinicio.

Cuando se acepta una solicitud, la respuesta incluye un ID de operación:

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

Ejemplo de respuesta:

{
  "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
}

Puedes encontrar todos los detalles en la documentación de la API sobre cómo comprobar la disponibilidad de copias de seguridad y crear una copia de seguridad descargable.

Integra más flujos de trabajo de MyKinsta en tus propias herramientas

Estas actualizaciones amplían el acceso programático a varios flujos de trabajo cotidianos de MyKinsta.

En conjunto, estas novedades facilitan la gestión coherente de los entornos de WordPress en paneles de control internos, scripts de aprovisionamiento, flujos de trabajo de despliegue y otras automatizaciones creadas con la API de Kinsta.