# Named access control lists (IRPCNamedACLs)

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Vault API](https://developer.m-files.com/APIs/gRPC-API/vault/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedACLs/

Lists the named access control lists that the calling user can see.

Provides methods for read-only access to named ACLs.

- **gRPC service:** `MFiles.IRPCNamedACLs`
- **Book and level:** [Vault API](https://developer.m-files.com/APIs/gRPC-API/vault/index.md), standard
- **Methods:** 1
- **Proto file:** [`mfiles/IRPCNamedACLs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/IRPCNamedACLs.proto)

<a id="overview"></a>

## Overview

A named access control list (named ACL) is a reusable, named set of permissions that
administrators define in the vault, such as "Visible to company management only". Users pick
one when they set the permissions of an object. Use
[GetNamedACLs](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedACLs/GetNamedACLs/index.md) to fill a permissions picker or to resolve a named ACL ID that you find in an
[AccessControlList](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AccessControlList/index.md).

The service is read-only. Creating and editing named ACLs is an administrative operation. For
how permissions work, see
[Permissions](https://developer.m-files.com/APIs/gRPC-API/concepts/permissions/index.md).

<a id="methods"></a>

## Methods

| Method | Summary | Facts |
|---|---|---|
| [GetNamedACLs](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedACLs/GetNamedACLs/index.md) | Gets the named ACLs of the given types that the calling user is allowed to see. | `read` `session or assertion` `idempotent` `returns metadata structure version` |