Herald
OpenapiSystem

Resolve the current request host to a published custom-domain realm.

Used by the SPA on custom domains before it knows the realm id. This endpoint is intentionally separate from the internal Caddy ask endpoint: the ask endpoint stays shared-secret protected and never leaks realm identity, while this public endpoint is only for hosts already serving the app.

GET
/api/public-config/custom-domain/resolve

Used by the SPA on custom domains before it knows the realm id. This endpoint is intentionally separate from the internal Caddy ask endpoint: the ask endpoint stays shared-secret protected and never leaks realm identity, while this public endpoint is only for hosts already serving the app.

Query Parameters

host?string

Optional hostname override; defaults to request Host header

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/public-config/custom-domain/resolve"
{  "publicConfig": {    "oauthProviders": [      {        "displayName": "string",        "enabled": true,        "name": "string"      }    ],    "realmDescription": "string",    "realmName": "string",    "registration": {      "enabled": true,      "requireEmailVerification": true    },    "whiteLabel": {      "accentColor": "string",      "background": null,      "brandName": "string",      "faviconUrl": "string",      "footerText": "string",      "loginSubtitle": "string",      "loginTitle": "string",      "logoUrl": "string",      "registerSubtitle": "string",      "registerTitle": "string"    }  },  "realmId": "string"}
{  "code": "string",  "details": null,  "message": "string",  "requestId": "string",  "status": 0}
{  "code": "string",  "details": null,  "message": "string",  "requestId": "string",  "status": 0}