API
Check the web app address now
Checks the web app address at once, whether its CNAME record answers and its certificate is issued, and returns it with what the check found. No body.
POST/app-host/verify
Runs the real call on your workspace.
POST /app-host/verify
Checks the web app address at once, whether its CNAME record answers and its certificate is issued, and returns it with what the check found. No body.
Example
Needs domains:write.
curl -X POST "$OE/app-host/verify" -H "$AUTH"{ "object": "app_host", "id": "ahost_3f9c2a71d0b84e56a1c7f2e9", "host": "mailbox.acme.com", "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "domain": "acme.com", "status": "active", "active": true, "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": "2026-10-01T09:04:11.000Z", "available": true, "paidPlan": true, "domains": ["acme.com"], "suggested": "mailbox.acme.com"}A check that ran in the last 10 seconds is not repeated, and the address comes back as it stands.
With no address set, nothing is checked and status is none.
