---
title: "Get Role List"
method: GET
path: "/openapi/v2.0/organizations/{uuid}/roles"
tags: ["Organization & Project/Members & Permissions Management/Roles & Permissions"]
---

# Get Role List

`GET /openapi/v2.0/organizations/{uuid}/roles`

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/openapi/v2.0/organizations/{uuid}/roles`
- Auth: none required

Get all project-level custom roles of this organization plus globally non-project-joined preset roles, for the role management page

## Path parameters

- `uuid` string, uuid, required

## Query parameters

- `type` string, required
- `page` integer
- `page_size` integer

## Headers

- `X-User-Token` string, required
- `X-Request-Id` string
- `X-Language` string

## Response `200`

Business success (see 'Response Example' in the Markdown documentation for specific data)

- object
  - `code` integer: Non-zero Indicates Exception
  - `message` string: Message Prompt
  - `data` object: Business Data
    - `pagination` object: Pagination Info
      - `page` integer: Current page number, starts from 1
      - `page_size` integer: Items Per Page
      - `total` integer: Total Count
    - `list` object[]: Role List
      - `role_id` string: Role ID (business string, e.g., project-commander or custom role UUID)
      - `role_name` string: Role Name (i18n)
      - `role_description` string: Role Description
      - `workspace_id` string: Owning workspace; empty for preset roles
      - `is_preset` boolean: Whether It Is a System Preset Role
      - `is_add_to_org` boolean: Whether Role Is Enabled by Organization
      - `role_type` string: Role type: project / organization
      - `is_name_use_i18n` boolean: Whether role_name uses i18n
      - `is_remark_use_i18n` boolean: Whether role_description uses i18n
      - `created_at` string, date-time: Role Created At
      - `updated_at` string, date-time: Role Updated At
      - `deleted_at` string, date-time, nullable: Role deletion time; null if not deleted
      - `permissions` object[]: Flat List of Permissions for This Role
        - `permission_id` string: Permission ID (business string, e.g., manage-project / device-control)
        - `permission_name` string: Permission Display Name (i18n)
        - `permission_description` string: Permission Description
        - `level` integer: Permission Level
        - `is_visible` boolean: Whether Frontend Should Display This Item
        - `is_basic_permission` boolean: Whether Basic Permission
        - `path` string: Permission Path (dot/slash-delimited hierarchy)
        - `permission_type` string: Ownership: project / organization
        - `sequence` integer: Sort Order Index
        - `predecessor` string[], nullable: Prerequisite Permission ID List; these are required to hold this permission
        - `frontend_resources` string[], nullable: Frontend Resource Identifier List
        - `resources` string[], nullable: Backend Resource List
        - `extended_resources` string[], nullable: Extended Resource List
        - `related_permissions` string[], nullable: Related Permission List
        - `created_at` string, date-time: Permission Created At
        - `updated_at` string, date-time: Permission Updated At
        - `deleted_at` string, date-time, nullable: Permission deletion time; null if not deleted
        - `children` object[]: Sub-Permissions

## Other responses

- `401`: Login expired or Authorization not provided
- `403`: Account does not have permission to access this resource
- `500`: Service temporarily unavailable, please retry later

---

[API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/revisions/aeef0010be34?raw)