Referencia de herramientas

Esta página se genera a partir del propio servidor, así que siempre coincide con lo que ve tu agente. No necesitas aprendértela para usar Dilohost: basta con pedir las cosas con tus palabras. Sirve para entender qué hace el agente por debajo, para revisar permisos o para construir tu propia integración.

Cómo se usan#

Cada herramienta agrupa varias acciones relacionadas. El agente elige la acción con el parámetro action y añade los parámetros que esa acción necesita:

{
  "name": "database",
  "arguments": { "action": "create", "project": "tienda", "name": "datos", "engine": "postgres" }
}

Todas las herramientas admiten además dos parámetros comunes:

En las tablas, Quién puede dice quién puede usar cada acción: Equipo es cualquier persona de la cuenta y los tokens de servicio (Equipo · lee marca las acciones que solo consultan); Solo el propietario, quien creó la cuenta. Ver Equipo.

Resumen#

account#

Cuenta · Solo lectura

Información de la cuenta de Dilohost: con quién está conectado el agente, el plan y sus límites, lo que se ha gastado de cada límite, el catálogo de planes con precios y las últimas acciones registradas. Acciones: info, usage, plans, audit.

billing#

Plan y pagos · Escribe, no borra

Contratar y pagar el plan de la cuenta (contratar, cambiar de plan, el método de pago, los datos fiscales y el tope de gasto, solo el propietario de la cuenta; el saldo y las recargas, cualquier persona del equipo). Los pagos se hacen en las páginas seguras de Stripe, con el enlace que devuelve la acción: los datos de tarjeta nunca pasan por este servidor. Flujo: account.plans para elegir → billing.profile con los datos de facturación (nombre o razón social, país, zona si es España, particular o empresa, NIF) → billing.checkout (plan, period month|year) → la persona paga en el enlace → billing.status. Con un plan ya activo: billing.change_plan (pide confirmación y muestra lo que se cobra ahora), billing.portal (método de pago, recibos y cancelación al final del periodo), billing.invoices. Precios sin IVA; el IVA se calcula según los datos de facturación (21 % en España peninsular y Baleares; sin IVA en Canarias para empresas, Ceuta y Melilla, y para empresas de la UE con NIF-IVA válido). Uso: cada plan incluye crédito de uso al mes (Gratis 1 €); lo medido se gasta a tarifa (account.plans la muestra). billing.usage da lo gastado, el crédito que queda y el tope de gasto; billing.spend_cap lo cambia (euros de exceso al mes, o "none"). En Gratis, el exceso se paga del monedero y, sin saldo, las apps se paran hasta el día 1. Saldo: billing.balance y billing.add_funds (dominios y uso extra del plan Gratis). Acciones: status, usage, spend_cap, profile, checkout, change_plan, portal, invoices, balance, add_funds.

domain#

Dominios · Puede cambiar o borrar

Dominios propios para las webs (el plan Gratis admite uno, comprado aquí o traído). - Buscar y comprar: search (disponibilidad y precio; .es, .com, .net, .org, .eu, .dev, .app) → contact_create (titular: siempre la persona o empresa cliente, con su NIF) → buy (pide confirmación con el precio; se paga con el saldo de billing.add_funds, salvo el dominio incluido en el pago anual). - Traer uno que ya tiene: connect (da un registro TXT para demostrar que es suyo) → la persona lo crea en su DNS actual → verify → si mode="delegated", cambia los nameservers en su registrador a ns1/ns2.dilohost.es (las instrucciones salen en verify) → status hasta que esté activo. Con mode="records" no se cambian los nameservers: solo se apunta la web desde su DNS. - Web: attach (dominio + project + app) → certificado HTTPS automático cuando el dominio ya apunta aquí → status. detach la quita. - Mantenimiento: list, status, renew, auto_renew, transfer_in (traerse el registro desde otro registrador; antes hay que conectarlo y verificarlo), transfer_code (para llevárselo: se envía por correo), remove. Los registros DNS se gestionan con la tool dns. Acciones: search, contact_create, contacts, buy, connect, verify, status, list, attach, detach, renew, auto_renew, transfer_in, transfer_code, remove.

dns#

DNS · Puede cambiar o borrar

Registros DNS de los dominios cuyo DNS gestiona Dilohost (comprados aquí o traídos con mode="delegated"). - list: registros actuales (los «gestionados» los pone la plataforma: nameservers y, con la web conectada, el A de la raíz y www). - set: crea o sustituye todos los valores de un nombre y tipo (name «@» = raíz; «www», «blog», «_dmarc»…; type A, AAAA, CNAME, MX, TXT, SRV, CAA, NS; values lista; ttl 60-86400). - delete: borra un nombre y tipo (pide confirmación). - preset: configura el correo de un proveedor o una verificación: google_workspace, microsoft365 (value = host MX que da Microsoft), zoho, search_console (value = código). El SPF se fusiona con el que haya. Se valida todo antes de escribir: un CNAME no convive con otros registros, un solo SPF por nombre, CAA compatible con el certificado de la web. Acciones: list, set, delete, preset.

email#

Correo · Puede cambiar o borrar

Buzones de correo con el dominio de la persona (info@sudominio.es), con IMAP/POP/SMTP y webmail. El dominio tiene que estar en la cuenta: con su DNS en Dilohost (delegated o comprado aquí) ponemos los registros; con su DNS fuera (mode="records") los pone la persona. - list: dominios con correo, sus buzones y los dominios donde se puede activar. - enable (domain): activa el correo; con el DNS en Dilohost pone MX, SPF, DKIM, DMARC y SRV; si el DNS está fuera (domain.connect con mode="records"), devuelve los registros que la persona tiene que poner allí (pide confirmación). - status (domain): si ya se puede enviar (al activar se recibe enseguida; enviar espera a que se verifique el dominio, minutos). - disable (domain): desactiva el correo de un dominio sin buzones. - create (address, name, password): crea un buzón (pide confirmación con el coste). La contraseña es opcional (12+ caracteres); sin ella, se pone después en el panel de dilohost.es. password (address, password) la cambia. - delete (address): borra el buzón y TODOS sus mensajes (pide confirmación). - aliases (address, aliases): direcciones extra que llegan a ese buzón (p. ej. ["ventas","hola"]); sustituye la lista. - settings: datos para configurar el móvil u Outlook. - Reenvío a otro correo (p. ej. su Gmail): solo se activa en el panel (Correo → Reenvío); list muestra a dónde reenvía cada buzón. - Traer el correo de otro proveedor (Gmail, Migadu, IONOS…): guide describe el flujo completo; migrate (address, source_user, source_password; o link=true si la persona prefiere escribirla en un enlace), migrate_status, migrate_again (otra pasada tras cambiar el MX) y migrate_close. Al final, old_records/clean_old_records (domain): restos del proveedor antiguo. Acciones: list, enable, status, disable, create, password, delete, aliases, settings, guide, migrate, migrate_status, migrate_again, migrate_close, old_records, clean_old_records.

project#

Proyectos · Puede cambiar o borrar

Proyectos de la cuenta: cada uno agrupa sus webs y apps, bases de datos, buckets y tareas. Acciones: create, list, info, delete (va a la papelera 30 días; pide confirmación), export (zip con el código, las variables y enlaces a las copias).

deploy#

Publicar · Puede cambiar o borrar

Publica webs y apps en https://<app>-<proyecto>-<cuenta>.dilosite.es. guide explica cómo subir el código y cómo prepararlo para que el build tarde poco. Acciones: guide, publish, git_remote, git_revoke, connect_repo, sync, repo, disconnect_repo, subdomain, redeploy, status, history, rollback. Formas de subir el código: 1. git_remote: remoto git de Dilohost + credencial de 1 h; git push a main publica. Para agentes con terminal. 2. connect_repo: su repositorio de GitHub, GitLab, Bitbucket, Codeberg u otro, con clave de despliegue de solo lectura (y webhook); después sync. 3. tool upload mode="agent": zip por URL firmada. 4. tool upload mode="page": enlace para que la persona arrastre el zip. publish con files (texto, ≤400 ficheros, 8 MB) para webs pequeñas y cambios puntuales; con git_url, repos públicos. Con index.html y sin package.json/composer.json/Dockerfile: web estática al instante. Lo demás se construye (Node, PHP, Python, Go, Ruby… o su Dockerfile): status da el progreso hasta «live» o «failed» y, si el build se puede acelerar, para_que_tarde_menos. dockerfile=false ignora el Dockerfile del repo (p. ej. el de otro hosting); en PHP/Laravel es mucho más rápido. La app escucha en la variable PORT (8080). subdomain: .dilosite.es si está libre ("default" vuelve a la de siempre; pide confirmación). Dominios propios: tool domain. git_revoke anula las credenciales de git de la app. rollback vuelve a una versión anterior sin reconstruir.

app#

Apps · Puede cambiar o borrar

Operación de una app, web, worker o tarea ya publicada. Acciones: status, logs (últimas líneas), restart, resources (límites de memoria y CPU del plan), disk (ampliar su disco persistente con size_mb: se concede si el servidor tiene sitio; se cobra por lo que ocupe), run (comandos de mantenimiento como migraciones; lista cerrada), diagnose (explica por qué no funciona y qué hacer), traffic (visitas de una web: páginas vistas, visitantes, páginas más vistas, orígenes, códigos de respuesta, robots y tiempos; últimos 14 días como máximo).

config#

Variables de entorno · Puede cambiar o borrar

Variables de entorno de una app (se aplican reiniciándola). Los secretos (secret=true) se guardan cifrados y no se vuelven a mostrar nunca por aquí (si se pierden, se cambian por uno nuevo). Acciones: list, set, unset (pide confirmación).

database#

Bases de datos · Puede cambiar o borrar

Bases de datos PostgreSQL o MySQL del proyecto, cada una con su usuario propio. Acciones: create, list, connection (con inject_into="" guarda la conexión como variables secretas de esa app sin mostrar la contraseña; recomendado), delete (pide confirmación; la base va con sus datos). Las copias están en la tool backup.

backup#

Copias de seguridad · Puede cambiar o borrar

Copias de las bases de datos, guardadas fuera del servidor. Se hace una cada noche automáticamente y se conservan según el plan (7 o 30 días). Acciones: now (copia ahora), list, restore (sustituye los datos actuales por los de la copia; pide confirmación), download_link (enlace de descarga válido 1 hora).

storage#

Almacenamiento de ficheros · Puede cambiar o borrar

Crear y gestionar buckets compatibles con S3 para guardar ficheros de las apps (fotos, documentos…), cada uno con su clave propia. Para ver los buckets o descargar un fichero, la tool storage_read. Acciones: create_bucket, connection (con inject_into="" guarda AWS_* como variables secretas de la app), upload_url (enlace temporal de 1 hora para subir un fichero con PUT), delete (pide confirmación; borra el bucket y sus ficheros).

storage_read#

Ver almacenamiento de ficheros · Solo lectura

Consultar los buckets de ficheros de un proyecto, sin cambiar nada. Acciones: list (buckets, capacidad y estado), download_url (enlace temporal de 1 hora para descargar un fichero; object = su ruta dentro del bucket). Crear, conectar a una app, subir o borrar: tool storage.

jobs#

Tareas y procesos · Puede cambiar o borrar

Procesos que reutilizan el código de una app ya publicada: add_worker (un proceso que corre siempre, p. ej. "php artisan queue:work") y add_cron (un comando programado, formato cron, hora de Madrid; mínimo cada 5 minutos). Acciones: add_cron, add_worker, list, remove (pide confirmación).

team#

Equipo · Puede cambiar o borrar

Equipo de la cuenta: las personas que la comparten (sus webs, su plan y su saldo). Hay un propietario (quien la creó) y usuarios invitados, que pueden hacerlo todo salvo gestionar el equipo, el plan o el pago. Acciones: list, invite (solo el propietario; queda pendiente hasta que la apruebe en el panel de dilohost.es y entonces se envía el correo), remove (solo el propietario; pide confirmación).

trash#

Papelera · Puede cambiar o borrar

Proyectos borrados: se guardan 30 días con todos sus datos y se pueden recuperar. Acciones: list, restore, purge (borra para siempre antes de tiempo; pide confirmación).

upload#

Subir proyecto · Puede cambiar o borrar

Sube un proyecto entero en un .zip (hasta 200 MB; 1 GB descomprimido) y lo publica. Es la alternativa a git (deploy.git_remote) y a conectar un repositorio (deploy.connect_repo). - mode="agent" (para clientes que pueden hacer peticiones HTTP, p. ej. con curl): begin devuelve un formulario firmado y el comando curl listo; commit confirma la subida. - mode="page" (para clientes que no pueden subir ficheros, p. ej. un chat web como claude.ai o ChatGPT): begin devuelve un enlace donde la persona arrastra el zip, que se publica solo; status da el estado. El zip sustituye el código anterior de la app (el historial se conserva y se puede volver atrás). Se respeta el .gitignore; node_modules, vendor y los builds no hacen falta. Los enlaces caducan a los 15 minutos y valen para una sola subida. Acciones: begin, commit, status.

feature_request#

Pedir una función · Escribe, no borra

Peticiones de funciones al equipo de Dilohost, para lo que la persona necesita y ninguna tool cubre. - create: title (una frase), need (qué quería conseguir la persona y para qué, con sus palabras), tried (qué tools se probaron y por qué no bastaban), proposal (opcional: cómo se podría resolver), area (opcional: tool o tema). - list: las peticiones de esta cuenta y en qué estado están. Las peticiones las lee el equipo; no llevan contraseñas, claves ni datos personales de terceros. Acciones: create, list.