Hemos mejorado la API de Kinsta con nuevas funciones de gestión de dominios y usuarios, lo que proporciona a los equipos aún más control sobre sus entornos, sin necesidad de iniciar sesión en  MyKinsta.

Con estas actualizaciones, ahora puedes cambiar mediante programación el dominio principal de un entorno de WordPress y gestionar completamente cuentas SFTP adicionales a través de la API de Kinsta.

Cambiar el dominio principal de un entorno

Anteriormente, la API de Kinsta te permitía añadir o eliminar dominios de tu sitio, lo que era genial para la configuración y la limpieza. Pero no podías cambiar qué dominio se establecía como primario para un entorno.

Con esta nueva versión, ahora puedes establecer un dominio existente como el nuevo dominio primario para un entorno específico utilizando el siguiente endpoint:

PUT /sites/environments/{env_id}/change-primary-domain

Para utilizar el endpoint, necesitas la dirección domain_id del dominio que quieres establecer como primario. Debe ser uno de los dominios ya asociados al entorno.

Puedes encontrar el domain_id utilizando los endpoints Get Site by ID o Get Site Environments. En la respuesta aparece algo similar a esto:

"domains": [
  {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "name": "example.com",
    "type": "live"
  }
]

También tienes que configurar el campo run_search_and_replace. Cuando se establece en true, se activa un proceso de buscar y reemplazar en toda la base de datos del sitio para actualizar las URL que hacen referencia al dominio.

Aquí tienes un ejemplo usando curl:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/change-primary-domain' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domain_id": "your-domain-id",
    "run_search_and_replace": true
  }'

Soporte completo para gestionar cuentas SFTP adicionales

En abril, añadimos la posibilidad de crear y gestionar múltiples cuentas de usuario SFTP directamente en el panel de MyKinsta. Ahora, puedes hacer todo eso utilizando la API de Kinsta.

Esto te da un control programático total sobre los usuarios SFTP adicionales en cada entorno. Puedes habilitar el acceso, añadir nuevos usuarios, listar los existentes o eliminarlos por completo.

Activar o desactivar el acceso

Antes de añadir usuarios, debes activar el acceso SFTP adicional para el entorno. Puedes hacerlo con:

PUT /sites/environments/{env_id}/additional-sftp-accounts/toggle-status

Aquí tienes un ejemplo usando curl:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/additional-sftp-accounts/toggle-status' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "enabled": true
  }'

Esto se puede revertir en cualquier momento configurando "enabled": false.

Añadir un nuevo usuario SFTP

Una vez activado, puedes añadir usuarios con este endpoint:

POST /sites/environments/{env_id}/additional-sftp-accounts

La solicitud te permite definir un nombre de usuario, una contraseña segura (mínimo 16 caracteres), el directorio raíz y un nivel de permiso (read o write).

curl -i -X POST \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/additional-sftp-accounts' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "dev-user",
    "password": "R8zXwT@#bV!kJq9^",
    "root_directory": "/wp-content/themes",
    "permission": "write"
  }'

Esto refleja los mismos controles que encontrarías en MyKinsta, incluida la posibilidad de restringir el acceso a directorios específicos o asignar permisos de sólo lectura.

Listar y eliminar usuarios

Puedes recuperar una lista de cuentas SFTP adicionales de la siguiente manera:

GET /sites/environments/{env_id}/additional-sftp-accounts

Para eliminar una:

DELETE /sites/environments/additional-sftp-accounts/{sftp_account_id}

Esto te da total flexibilidad para automatizar la rotación de cuentas, conceder acceso limitado a colaboradores o revocar credenciales después de un despliegue.

Nuevos metadatos en los listados de entornos

Para dar soporte a estas nuevas capacidades, hemos añadido el campo is_additional_sftp_accounts_enabled a los siguientes endpoints:

Esto facilita la auditoría de los entornos que tienen habilitado el acceso SFTP adicional, especialmente si gestionas muchos en tu plataforma o cuentas de clientes.

Más control para los equipos modernos

Estas nuevas funcionalidades de la API te proporcionan un mayor control sobre tu infraestructura, tanto si estás automatizando flujos de trabajo de staging, rotando credenciales SFTP o cambiando direcciones URL de sitios mediante programación.

Puedes encontrar todos los detalles de solicitud/respuesta en la documentación de la API de Kinsta. Puedes hacer muchas cosas con la API de Kinsta, y muchas agencias y desarrolladores ya confían en ella para gestionar cientos de sitios de forma eficiente.

¿Listo para empezar? Dirígete a MyKinsta para generar tu token API y empezar a construir.