A valid request URL is required to generate request examples{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Disconnect the custom portal domain
Requires org:update, and nothing else on any plan. Removing an address is reducing your own exposure, and a plan that stood between an administrator and taking their own page down would be a lockout wearing a price tag.
The host is released at the edge first, and only then here. If that fails the call answers 503 and nothing is changed — the domain stays connected to this environment and the portal goes on answering on it. That is deliberate: while the address still routes to us, the record of who owns it is what stops anybody else connecting the same host, so releasing it early would leave the name attached with no owner.
On 204 the portal stops answering on that host immediately.
A valid request URL is required to generate request examples{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Authorizations
A staff session token, uk_st_…. Minted by sign-up, sign-in or the two-factor exchange. Only a 401 means it is spent; not_a_member (403) is about the organization named in X-Organization-Id and leaves the token good for the others.
Headers
The organization the caller is acting on — the org_… code that appears in the panel URL. It identifies; the membership JOIN is what authorizes, so a forged code reads nothing: the answer is not_a_member (403), which does not mean the session is over. Absent, the session's default organization answers, or — if that membership was revoked while the session was open — any other one the caller still holds.
Path Parameters
The environment's id.
Response
Disconnected.