Skip to main content
DocumentationLibraryReference
On this page

Kater CLI Share and administer admin access

kater admin access grant

Gives a member, a group or Everyone an access level on a file or folder.

It replaces any level they had on that path, and keeps their Can execute. Everything in a folder inherits the grant, unless a folder below it is restricted.

Examples

Terminal window
# Let everyone in the organisation view the ad_reporting workspace
kater admin access grant connections/snowflake_prod_connection/workspaces/ad_reporting --level viewer --everyone
# Let one person edit it
kater admin access grant connections/snowflake_prod_connection/workspaces/ad_reporting --level editor --user teammate@example.com
# Let the Marketing group manage every workspace of the connection
kater admin access grant connections/snowflake_prod_connection/workspaces --level manager --group Marketing

Arguments

ArgumentDescription
<path>The file or folder to give access to, from the content root, such as connections/snowflake_prod_connection/workspaces/ad_reporting.

Options

OptionDescription
--level <level>Required. The level to give. viewer can view, editor can also change and delete, and manager can also change who has access.
--user <user>A member, by email address or user id, such as teammate@example.com.
--group <group>A group, by name or id, such as Marketing.
--everyoneGives the level to everyone in the organisation.

It also takes the global options --json and --help.

Name one grantee

Give one of --user, --group or --everyone, and only one. The name must match one member or one group exactly. When it does not, the command lists the members or groups that it found.

You need the Manager level on the path, or the access:administer permission.

See also