Groups

A group is a named set of workspace members. You grant a context layer permission or access to a model to the group once, and every member of the group gets it. A group does not change anyone's role.

This page describes how to create a group on the Team members tab, change its members and permissions, and use it on the Access tab of a context layer model.

Before you begin

Check the following before you create a group.

1. Owner role.
   Only workspace owners create, edit, and delete groups. Members can open the list and view a group. To check roles, see Team & Roles.
2. Accepted members.
   A group holds only members who have joined the workspace. Invite the people first and wait until they accept.

Create a group

You need the owner role in the workspace.

Open Team membersStep 1

In the left sidebar, click your profile at the bottom, and then click Teammates. The Team members tab of the workspace settings opens.

Open the Groups cardStep 2

Scroll down to the Groups card. It lists every group in the workspace with its member count, creator, and creation date. Click Add group.

Fill in the groupStep 3

Complete the form in the Add group panel.

1. Group name.
   A short name that is unique inside the workspace. Up to 100 characters.
2. Description.
   Optional. What the group is for. Up to 500 characters.
3. Members.
   Select members from the list. The list shows only members who have joined the workspace. A selected member appears below the picker, and the cross next to the name removes them again.
4. Context layer permissions.
   Optional. Select the permissions every member of the group gets: Read context layer models, Manage context layer models, or Run custom queries. See Permissions.

Click Create group.

Verify the groupStep 4

The group appears in the Groups card with its member count and your name as the creator.

Edit or delete a group

Click a group in the Groups card to open it. Owners see the Edit group panel. Members see the same fields in the read-only Group details panel.

1. Change the name or the description.
   Edit the fields at the top of the panel and click Save.
2. Add members.
   Select them in the Members picker. Renta saves the list as a whole when you click Save.
3. Remove a member.
   Click the cross next to the name, and then click Save. The person keeps their workspace access but loses the permissions and model access the group gave them.
4. Change permissions.
   Select or clear permissions in Context layer permissions, and then click Save. The change applies to every member of the group at once.
5. Delete the group.
   Click Delete group at the bottom of the panel and confirm. Members keep their workspace access. The group's permissions end, and the group is removed from every model it was attached to.

Grant a group access to a model

Groups control who can describe and query a context layer model through AI agents and the Renta API. Owners always have access. A member needs two things: the Read context layer models permission, and the model on its Access tab, either directly or through a group. A group can give both.

1. In the left sidebar, click Context layers and open the model.
2. Open the Access tab.
3. In the Groups card, click Add groups, select the group, and then click Add groups in the panel.
4. Click Save changes.

Every member of the group can now use the model. The Users card on the same tab grants access to individual members without a group.

Limits

The following limits apply to groups in a workspace.

What's next

Manage the team the groups are built from, or set up the models they grant access to.