Hanzo
OpenapiPlatform

Deletes an application and tears down what it runs.

Deletes an application and tears down what it runs.

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

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

Deletes an application and tears down what it runs.

It removes the application record and tears down what it owns in the org's tenant namespace — its operator Service CR and its KMSSecret — then answers 204. An app this org and project do not have is 404, never a silent success.

Teardown is best-effort by design: a cluster that refuses or is unreachable does not block the delete, so the record cannot be left orphaned behind a broken cluster; the failure is logged for operators and the orphan reaper reconciles it. Requires a validated principal; 403 without one.

Request

2 fields.

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

Response

StatusBodyMeaning
204no content

Failure carries the platform error shape — see Errors.

Examples

hanzo platform projects apps rm <project> <app>

Platform API · All Hanzo APIs · Interactive reference

How is this guide?

On this page