# 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>


---

# 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://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-organization/role/add.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.