Updated at July 17, 2026 02:08 PM
box.schema.role.drop()
Drop a role. For explanation of how Tarantool maintains role data, see section Roles.
Parameters:
-
role-name(string) — the name of the role -
options(table) —if_exists=true|false(default =false) - boolean;truemeans there should be no error if the role does not exist.
Example:
box.schema.role.drop('writers_space_reader')-- Test roles exist --t.assert_equals(box.schema.role.exists('books_space_manager'), true)t.assert_equals(box.schema.role.exists('all_spaces_manager'), true)t.assert_equals(box.schema.role.exists('writers_space_reader'), false)end)end
See also: access_control_roles.