v4

latestOpenAPI 3.1.1Apache 2.02026-07-31107278570.4 KB
Permissions

Delete permission

Permanently removes a permission from the environment using its unique name identifier. Use this endpoint when you need to clean up unused permissions or remove access controls that are no longer relevant. The permission is identified by its name in the path parameter following the format 'action:resource'. This operation cannot be undone, so ensure no active roles depend on the permission before deletion. If the permission is currently assigned to any roles, you may need to remove those assignments first or update the roles to use alternative permissions. Returns no content on successful deletion.

delete/api/v1/permissions/{permission_name}

Path parameters

permission_namestring required

Name of the permission

Response

Permission successfully deleted. No content returned.

{"stackTrail":"paths:/api/v1/permissions/{permission_name}:delete:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}