> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-organization/role/add.md).

# add

The cldkctl organization role add command defines a new role within the organization and specifies which services and permissions members assigned to this role can access. Administrators can create custom roles with specific privileges by defining viewer and editor permissions for different services.

## Usage

```
cldkctl organization role add [flags]
```

## Steps

Follow the steps below to run and view the result of this command:

1. Prepare the details for your new role, including the role name, description, and the list of services that will have viewer and editor permissions.
2. Run the following command in your terminal:

```
cldkctl organization role add \
--name <role_name> \
--description "<description>" \
--editor <service_name> \
--viewer <service_name>
```

3. Replace \<role\_name> with the name of your new role, with a short explanation of the role’s purpose, and \<service\_name> with the service names that will be assigned as editor or viewer.
4. After running the command, wait for the process to complete until the CLI displays a success message confirming that the role has been created successfully.

<figure><img src="/files/0iBIYbRmg3ETBFVxUkyU" alt=""><figcaption></figcaption></figure>

## Flags

{% hint style="success" %}
This command supports refer to the [Global Flags ](/cloudeka-api-list/global-flags.md)section for details.
{% endhint %}

<table><thead><tr><th width="214.6666259765625">Column</th><th>Description</th></tr></thead><tbody><tr><td>-d, --description string</td><td>Description of the role.</td></tr><tr><td>--editor strings</td><td>Editor privileges for the specified services (comma-separated).</td></tr><tr><td>-h, --help</td><td>Help for the add command.</td></tr><tr><td>-n, --name string</td><td>Full name of the new role.</td></tr><tr><td>--viewer strings</td><td>Viewer privileges for the specified services (comma-separated).</td></tr></tbody></table>