Hanzo
OpenapiProjects

Gives a custom hostname back, so the name is free to reuse.

Gives a custom hostname back, so the name is free to reuse.

DELETE /v1/projects/{slug}/domains/{host}

Addresshttps://api.hanzo.ai/v1/projects/{slug}/domains/{host}
MethodDELETE
Operationdelete_projects_by_slug_domains_by_host
AuthAuthorization: Bearer $HANZO_API_KEY

Gives a custom hostname back, so the name is free to reuse.

A claim is FIRST-COME and global, so an add-only surface was not ownership but a leak: a customer who mistyped a domain, or claimed one they later moved elsewhere, could neither reuse it nor let anyone else. This is the third writer that closes it. The release is scoped to (host, org, slug), so it can only ever drop THIS tenant's own claim, and it is IDEMPOTENT: releasing a host we do not hold is a clean 204, never a 404 that would let a caller probe which hosts other tenants hold. The edge cache-tag is flushed, since the host stops routing here.

Scope: a validated principal is required (403 without one) and the site is resolved within that principal's org, so another tenant's slug is a 404.

Request

2 fields.

FieldInTypeRequiredDescription
slugpathstringyesSlug is the project the host is attached to, from the path.
hostpathstringyesHost is the custom hostname, from the path.

Response

StatusBodyMeaning
204no content

Failure carries the platform error shape — see Errors.

Examples

hanzo projects domains rm <slug> <host>

Projects API · All Hanzo APIs · Interactive reference

How is this guide?

On this page