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


---

# 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/list.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.