API
WebアプリのURL を設定する
ワークスペースの WebアプリのURL を設定し、既存のものがあれば置き換えて、公開する CNAMEレコードとともに返します。
PUT/app-host
実際の呼び出しをワークスペースに対して実行します。
PUT /app-host
ワークスペースの WebアプリのURL を設定し、既存のものがあれば置き換えて、公開する CNAMEレコードとともに返します。
リクエスト
パラメーター
hoststring必須- このワークスペースの検証済みドメインのサブドメイン（`mailbox.acme.com` など）で、最大 253 文字です。小文字化され、`https://` の接頭辞、パス、末尾のドットは取り除かれます。ドメインそのものは使えません。
例
domains:write、有料プラン、そしてアドレスやドメインの制限がないキーが必要です。
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"}アドレスは pending から始まります。record を DNS プロバイダーで示されたとおりに公開し、GET /app-host をポーリングするか POST /app-host/verify を呼び出してください。レコードが応答してから数分後、証明書が発行された時点で公開されます。
すでに設定されているアドレスを設定しても何も変わらず、再チェックが行われます。別のドメインのアドレスは準備ができた時点で古いアドレスを置き換え、同じドメインのアドレスはすぐに置き換えます。置き換えられたアドレスでサインインしていた人は全員サインアウトされます。
無料のワークスペースでは 403 plan_required が返ります。ワークスペースのドメイン外のアドレスは 422 invalid_app_host、未検証のドメインのアドレスは 409 domain_not_verified、別のワークスペースが使っているアドレスは 409 app_host_in_use になります。
