Définir l'adresse de l'application web
Définit l'adresse de l'application web de l'espace de travail, en remplaçant celle qu'il avait, et la renvoie avec l'enregistrement CNAME à publier.
Exécute le véritable appel sur votre espace de travail.
PUT /app-host
Définit l'adresse de l'application web de l'espace de travail, en remplaçant celle qu'il avait, et la renvoie avec l'enregistrement CNAME à publier.
La requête
Paramètres
hoststringobligatoire- Un sous-domaine d'un domaine vérifié de cet espace de travail, comme `mailbox.acme.com`, de 253 caractères au maximum. Il est mis en minuscules, et un préfixe `https://`, un chemin et un point final sont retirés. Le domaine lui-même ne peut pas être utilisé.
Exemple
Nécessite domains:write, une offre payante et une clé sans restriction d'adresse ni de domaine.
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"}L'adresse démarre en pending. Publiez record chez votre fournisseur DNS exactement tel qu'il est donné, puis interrogez GET /app-host régulièrement ou appelez POST /app-host/verify. Elle s'active quelques minutes après que l'enregistrement répond, une fois son certificat délivré.
Définir l'adresse que l'espace de travail a déjà ne change rien et la vérifie à nouveau. Une adresse sur un autre domaine remplace l'ancienne une fois configurée, et une adresse sur le même domaine la remplace tout de suite. Toutes les personnes connectées à une adresse remplacée sont déconnectées.
Un espace de travail sur l'offre gratuite répond 403 plan_required. Une adresse en dehors des domaines de l'espace de travail répond 422 invalid_app_host, une adresse sur un domaine non vérifié 409 domain_not_verified, et une adresse qu'utilise un autre espace de travail 409 app_host_in_use.
