> 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/list.md).

# list

The cldkctl organization role list command displays all available roles within the organization, along with their associated descriptions. This helps administrators identify which roles exist, understand their access scope, and obtain the Role ID needed for other operations such as adding, editing, or deleting roles.

## Usage

```
cldkctl organization cldkctl organization role list [flags]
```

## Aliases

```
list, ls
```

## Steps

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

1. Run the following command in your terminal `./cldkctl organization role list`
2. Wait a few moments while the CLI fetches the list of roles from the organization.
3. The result will display a table containing the list of roles, including their IDs, names, and descriptions.

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

<table><thead><tr><th width="138">Column</th><th>Description</th></tr></thead><tbody><tr><td>ID</td><td>The unique identifier assigned to each role.</td></tr><tr><td>Role Name</td><td>The name of the role defined within the organization.</td></tr><tr><td>Description</td><td>A short explanation of what the role allows users to do.</td></tr></tbody></table>

## 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="138">Column</th><th>Description</th></tr></thead><tbody><tr><td>-h, --help</td><td>Help for the list subcommand.</td></tr></tbody></table>