API
웹 앱 주소 설정
워크스페이스의 웹 앱 주소를 설정해 기존 주소가 있으면 대체하고, 게시할 CNAME 레코드와 함께 반환합니다.
PUT/app-host
워크스페이스에 실제 호출을 실행합니다.
PUT /app-host
워크스페이스의 웹 앱 주소를 설정해 기존 주소가 있으면 대체하고, 게시할 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로 응답합니다.
