# Custom roles

### Information

{% hint style="info" %}
This feature can be enabled upon request. Please contact us if you would like to use it.
{% endhint %}

On Cards, you can create custom roles to grant specific permissions to certain users or to AI agents (and MCP connectors).

Some use cases:

* Create a "Contributor" role that can only create and edit courses, without access to user management or statistics.
* Create a "Statistician" role that can view statistics without being able to edit course content.
* Adapt access to your organization and workflows with ease.

### List of custom roles

<figure><img src="/files/INYV618BxYhOHXVOgGUb" alt=""><figcaption><p>Custom roles</p></figcaption></figure>

### Create and edit a custom role

When you create a role, you start by giving it a name. You can also provide a description to help you remember the role's purpose.

You choose the type of role:

* User: the role is intended to be assigned to a "human" user
* AI Agent: the role is intended to be used on AI agents or MCP connectors.

Once the role is created, you will see the full list of available permissions, which you can then decide whether or not to grant to the role. Depending on the role type, the displayed permissions will differ (an AI agent has far fewer available permissions because it cannot perform all the operations available on Cards).

<figure><img src="/files/Bgg5CRQS9LkqNS5pwzIW" alt=""><figcaption><p>Edit custom role</p></figcaption></figure>

### Assign a role

Once the role is created and customized, you can associate it with users.

To do this, go to a user's edit page, and you will see the new role appear in the list of available roles:

<figure><img src="/files/cUOcE9K5YUgURCn7XFHe" alt=""><figcaption><p>Selecting custom role on a user</p></figcaption></figure>

Depending on the permissions assigned, the user will have certain links grayed out (and inaccessible) in the "management" part of Cards.

{% hint style="warning" %}
If you create a custom role without any permissions, the user will be able to access the "management" section but will only be able to view listings (users, training, categories, routines, etc.).

If you wish to completely block access to the management section, use the default "user" role.
{% endhint %}

To associate a role with an AI agent or an MCP connector, go to "App & Integrations". [See the documentation on AI agents](/english/apps-and-integrations/mcp.md).


---

# Agent Instructions: 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:

```
GET https://doc.cards-microlearning.com/english/my-space/custom-roles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.