Cannot delete a workspace after enabling the Developer Portal

After the Developer Portal is enabled, it is not possible to delete a workspace as it is not empty. Even disabling the Developer Portal does not allow the workspace to be deleted. An error message is shown that files and rbac_roles exist;

When enabling the Developer Portal, the default set of Pages, Partials and Specs are created. These entities need to be deleted to empty the Workspace before the workspace can be deleted.

To delete the entities, there are two options, both of these first require you to re-enable the Developer Portal so that the list of Pages, Partials and Specs can be viewed. Follow either option below;

Note: on Kong Gateway (Enterprise) 3.11.0.0 and later, the on-prem/Gateway-native Developer Portal is hard-deprecated and gated behind a separate, support-provided portal_and_vitals_key license extra. Without that key, every Portal-dependent Admin API route (/files, /<workspace>/files, /specs, etc.) returns a flat 404 regardless of the workspace’s config.portal setting — so on a standard Enterprise license, enabling the Developer Portal for a workspace will not actually create any Pages/Partials/Specs entities in the first place, and this specific “workspace won’t delete because Dev Portal files exist” scenario should not occur today. If you do hit it, your license likely already carries the portal_and_vitals_key extra, and the removal steps below remain valid.

1. Manually delete each entity until all of them have been removed
2. Use the kong-portal-cli tool — the deployment tooling for the template files in the separate kong-portal-templates repository. Follow the steps to install this utility and use a command similar to below to delete all the Developer Portal entities in one go;

portal wipe <workspace_name>

To delete the roles, refer to the KB below;

Cannot delete an empty workspace