Die Web-App-Adresse festlegen
Legt die Web-App-Adresse des Workspace fest, ersetzt eine bisherige und gibt sie mit dem zu veröffentlichenden CNAME-Eintrag zurück.
Führt den echten Aufruf in Ihrem Workspace aus.
PUT /app-host
Legt die Web-App-Adresse des Workspace fest, ersetzt eine bisherige und gibt sie mit dem zu veröffentlichenden CNAME-Eintrag zurück.
Die Anfrage
Parameter
hoststringerforderlich- Eine Subdomain einer verifizierten Domain dieses Workspace, etwa `mailbox.acme.com`, höchstens 253 Zeichen. Sie wird in Kleinbuchstaben umgewandelt, und ein vorangestelltes `https://`, ein Pfad und ein abschließender Punkt werden entfernt. Die Domain selbst kann nicht verwendet werden.
Beispiel
Erfordert domains:write, einen kostenpflichtigen Tarif und einen Key ohne Adress- oder Domain-Beschränkung.
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"}Die Adresse steht zunächst auf pending. Veröffentlichen Sie record genau wie angegeben bei Ihrem DNS-Anbieter, und fragen Sie dann GET /app-host regelmäßig ab oder rufen Sie POST /app-host/verify auf. Wenige Minuten, nachdem der Eintrag antwortet, geht sie live, sobald ihr Zertifikat ausgestellt ist.
Die Adresse festzulegen, die der Workspace bereits hat, ändert nichts und prüft sie erneut. Eine Adresse auf einer anderen Domain ersetzt die alte, sobald sie eingerichtet ist, und eine auf derselben Domain ersetzt sie sofort. Alle, die an einer ersetzten Adresse angemeldet sind, werden abgemeldet.
Ein Workspace im kostenlosen Tarif antwortet mit 403 plan_required. Eine Adresse außerhalb der Domains des Workspace antwortet mit 422 invalid_app_host, eine auf einer nicht verifizierten Domain mit 409 domain_not_verified und eine, die ein anderer Workspace verwendet, mit 409 app_host_in_use.
