Tarantool CE/EE Documentation portal logo
Support
Updated at July 17, 2026   02:08 PM

box.schema.role.drop()

box.schema.role.drop(role-name [, {options}])

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; true means 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.