Hanzo
OpenapiPlatform

Detaches a hostname and releases the claim.

Detaches a hostname and releases the claim.

DELETE /v1/platform/projects/{project}/apps/{app}/domains/{host}

Addresshttps://api.hanzo.ai/v1/platform/projects/{project}/apps/{app}/domains/{host}
MethodDELETE
Operationdelete_platform_projects_by_project_apps_by_app_domains_by_host
AuthAuthorization: Bearer $HANZO_API_KEY

Detaches a hostname and releases the claim.

It drops the host from the app's ingress and releases any custom claim on it, so the name becomes claimable again — by this org or any other. Answers 204.

The default host is permanent and cannot be removed: that is 400, not 404. A host that is neither attached nor claimed here is 404. Requires a validated principal; 403 without one.

Request

3 fields.

FieldInTypeRequiredDescription
projectpathstringyesProject is the project the application lives under, from the path.
apppathstringyesApp is the application's slug, from the path.
hostpathstringyesHost is the hostname, from the path.

Response

StatusBodyMeaning
204no content

Failure carries the platform error shape — see Errors.

Examples

hanzo platform projects apps domains rm <project> <app> <host>

Platform API · All Hanzo APIs · Interactive reference

How is this guide?

On this page