> For the complete documentation index, see [llms.txt](https://academy.decisionrules.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.decisionrules.io/spaces/users-in-spaces/roles.md).

# Roles

Use Roles to assign specific permissions to the users invited to your space.&#x20;

{% hint style="warning" %}
If you are using an Organization, the management of access and precise roles is handled in the Organizations' settings, not in this Space menu.
{% endhint %}

There are two ways to assign roles within the Space menu, you can either create a new custom role for the user or use one of our predefined roles. In addition, when creating new roles, you can use the predefined roles as templates that you copy to modify just a part of the permissions. See below for more details on the two types of role.

You can find role settings and assignment of roles under "Access" in the left sidebar menu of your Space settings.

<figure><img src="/files/O5PwriUR8qKdam9Y2BEh" alt=""><figcaption><p><mark style="color:purple;">Access Roles from the side menu</mark></p></figcaption></figure>

By assigning a role, you determine how individual users can interact with your space, your decision rules and other features. To assign a role to a user click on the 'Role' dropdown list next to the user’s name.

<figure><img src="/files/sRhwTex8Ke5ryTmm9qtz" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*You can not change the role of the space owner*
{% endhint %}

## Predefined roles

A user with the <mark style="color:purple;">Admin</mark> role is allowed to perform all activities in the space and has access to all rules and features. The <mark style="color:purple;">Editor</mark> has the same rights as the Admin except for setting up the space, managing users, and deleting API Keys. <mark style="color:purple;">Reader</mark> is allowed to just view the data and settings in each feature.

## Creating a new role

As mentioned, you can create new user roles for your project. You can create them in two ways. You can also edit the permissions of these roles at any time.

One way is by copying one of our predefined roles, where you can modify part of the permissions. In the example below, a new role similar to the Editor will be created, but the user will only be able to work with decision table rules.<br>

<figure><img src="/files/TPvNHF05Xoj56QdVYQcT" alt=""><figcaption><p><mark style="color:purple;">Creating a role from a template</mark></p></figcaption></figure>

The other way is to create a completely new role where you customize the permissions as needed. For example, you can create a new role where the user is only allowed to work with Decision Trees, plus they can change the space settings.

<figure><img src="/files/NEokqdGJFHZSjXuhHnQY" alt=""><figcaption><p><mark style="color:purple;">Creating a role from scratch</mark> </p></figcaption></figure>

If you no longer need them, you can delete any roles except the predefined ones. Click the ![](/files/3NgSxXoJbCVXb3AiCtB1) button next to the selected role and confirm to delete the role.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.decisionrules.io/spaces/users-in-spaces/roles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
