# Permissions

### Permissions: Defining User Actions

Permissions are the rules that specify the actions users within each group are allowed to perform. They ensure users interact with the application in a way that aligns with their assigned roles and responsibilities, maintaining security and organizational structure.

### Accessing Permissions in the Admin Console

To view and manage permissions:

1. Open the **Admin Console**.
2. Navigate to **Groups & Permissions** and select the **Permissions** tab from the left-hand menu.
3. On the **Permissions** page, you will see a card-based view, with each card representing a specific permission.

### Searching for Permissions

To locate specific permissions:

1. Use the **Search** box at the top of the permissions page.
2. Enter a relevant keyword related to the permission you're looking for.
3. Click the **Search** button to display matching permissions.

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

#### Create Permission&#x20;

To create a new permission:

1. Click the **Create Permission** button.
2. Fill in the required fields as described below.

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

3. Need to fill below fields,&#x20;

### Permission Details

***Permission Key:*** A unique identifier for the permission. This ensures each permission is distinct within the system.

***Permission Name:*** A human-readable label that describes the permission's purpose, making it easy to identify and manage.&#x20;

***Permission Description:*** Additional context about the permission's purpose and scope. Use this field to clarify its role and any specific use cases.&#x20;

***Metadata Fields (Optional):*** Metadata allows you to attach extra information to the permission in the form of **Key-Value pairs**.

* **Key**: Represents the name of the metadata field.
* **Value**: Provides the specific information or functionality associated with the key.\
  Use metadata to enhance the flexibility and functionality of your permissions.

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

3. After filling in all mandatory fields, click the **Save** button to create the new permission.

The permission will be added to the system and available for assignment or further configuration.

### Editing Permission&#x20;

To edit an existing permission:

1. Navigate to the **Permissions** page and locate the permission you wish to edit.
2. Click the **Edit** icon on the permission's table.

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

3. In the **Edit Permission** modal, make the desired changes, including the permission's **key**, **name**, **description**, and **metadata**.

<figure><img src="/files/3wmo3vw5wqi46xv1OfBP" alt=""><figcaption></figcaption></figure>

4. Once you've updated the necessary fields, click the **Save** button to apply the changes.

#### Delete Permission&#x20;

To delete a permission:

1. While in the **Edit Permission** modal, locate the **Delete** button.
2. Click the **Delete** button to initiate the deletion process.
3. A confirmation prompt will appear. Review the details carefully and confirm your decision to permanently delete the permission.

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

Once deleted, the permission will be permanently removed from the system and cannot be recovered.&#x20;


---

# 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://authdocs.skill-mine.com/licentio-documentation/groups-and-permissions/permissions.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.