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

# Query Project Role List Within Organization

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

## Request

- Base URL: `https://41b04hdzmc.apifox.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://41b04hdzmc.apifox.cn/openapi/v2.0/manage/api/v1/organizations/{uuid}/roles`
- Auth: none required

Paginated query of all project roles under current organization (including preset roles).
type only supports project.

## Path parameters

- `uuid` string, required

## Query parameters

- `page` integer
- `page_size` integer
- `type` 'project', required

## Headers

- `x-user-token` string, required
- `X-Request-Id` string, uuid
- `X-Project-Uuid` string, required

## Response `200`

OK

- object
  - `code` integer, required: Business Status Code: 0=Success; non-zero=Error Code (see message for meaning)
  - `message` string: Error Description Message (Omitted on Success)
  - `data` object: Role Paginated List
    - `list` object[]: Role List
      - `role_id` string: Role ID
      - `role_name` string: Role Name
      - `role_description` string: Role Description
      - `workspace_id` string: Owning Organization UUID
      - `is_preset` boolean: Is Preset Role
      - `is_add_to_org` boolean: Whether to Add to Organization
      - `role_type` 'organization' | 'project': Role Type. organization: Organization Role; project: Project Role
      - `is_name_use_i18n` boolean: Whether Role Name Uses i18n
      - `is_remark_use_i18n` boolean: Whether Role Remarks Use i18n
      - `created_at` string, date-time: Created At
      - `updated_at` string, date-time: Updated At
      - `deleted_at` string, date-time, nullable: Deletion Time
      - `permissions` object[]: Permission List
        - `permission_id` string: Permission ID
        - `permission_name` string: Permission Name
        - `permission_description` string: Permission Description
        - `level` integer: Permission Level
        - `is_visible` boolean: Visible
        - `is_basic_permission` boolean: Is Basic Permission
        - `path` string: Permission Path
        - `permission_type` string
        - `sequence` integer
    - `pagination` object: Pagination Info
      - `page` integer
      - `page_size` integer
      - `total` integer

## Other responses

- `500`: Service temporarily unavailable, please retry later

---

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