Updated at September 7, 2026 01:25 PM
box.schema.user.grant()
Grant privileges to a user or to another role.
Parameters:
username(string) — the name of a user to grant privileges topermissions(string) — one or more permissions to grant to the user (for example,readorread,write)object-type(string) — a database object type to grant permissions to (for example,space,role, orfunction)object-name(string) — the name of a database object to grant permissions torole-name(string) — the name of a role to grant to the useroptions(table) —grantor,if_not_exists
The user and the object must exist.
Variation: instead of object-type, object-name say universe, which means 'all object-types and all objects'. In this case, object name is omitted.
Variation: instead of permissions, object-type, object-name say
role-name (see section Roles).
Variation: instead of
box.schema.user.grant('{username}','usage,session','universe',nil, {if_not_exists=true}) say
box.schema.user.enable('{username}')
(see section box.schema.user.enable).
The possible options are:
grantor= grantor_name_or_id — string or number, for custom grantor,if_not_exists=true|false(default =false) — boolean;truemeans there should be no error if the user already has the privilege.
Example:
box.schema.user.grant('alice', 'read,write', 'space', 'books')
See also: access_control_users.