Configurar la dirección de la app web
Configura la dirección de la app web del espacio de trabajo, sustituyendo la que tuviera, y la devuelve con el registro CNAME que hay que publicar.
Ejecuta la llamada real en tu espacio de trabajo.
PUT /app-host
Configura la dirección de la app web del espacio de trabajo, sustituyendo la que tuviera, y la devuelve con el registro CNAME que hay que publicar.
La solicitud
Parámetros
hoststringobligatorio- Un subdominio de un dominio verificado de este espacio de trabajo, como `mailbox.acme.com`, de 253 caracteres como máximo. Se pasa a minúsculas, y se eliminan un prefijo `https://`, una ruta y un punto final. No se puede usar el propio dominio.
Ejemplo
Necesita domains:write, un plan de pago y una clave sin restricción de direcciones ni de dominios.
curl -X PUT "$OE/app-host" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "host": "mailbox.acme.com" }'{ "object": "app_host", "id": "ahost_3f9c2a71d0b84e56a1c7f2e9", "host": "mailbox.acme.com", "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "domain": "acme.com", "status": "pending", "active": false, "paused": false, "target": "cname.openemail.uk", "record": { "type": "CNAME", "name": "mailbox.acme.com", "value": "cname.openemail.uk" }, "error": null, "checkedAt": "2026-10-01T09:12:30.000Z", "verifiedAt": null, "available": true, "paidPlan": true, "domains": ["acme.com"], "suggested": "mailbox.acme.com"}La dirección empieza en pending. Publica record en tu proveedor de DNS exactamente como se indica, y luego consulta GET /app-host periódicamente o llama a POST /app-host/verify. Se activa unos minutos después de que el registro responda, una vez emitido su certificado.
Configurar la dirección que ya tiene no cambia nada y la vuelve a comprobar. Una dirección en otro dominio sustituye a la anterior en cuanto está configurada, y una en el mismo dominio la sustituye al momento. Se cierran todas las sesiones iniciadas en una dirección sustituida.
Un espacio de trabajo en el plan gratuito responde 403 plan_required. Una dirección fuera de los dominios del espacio de trabajo responde 422 invalid_app_host, una en un dominio sin verificar 409 domain_not_verified, y una que usa otro espacio de trabajo 409 app_host_in_use.
