Get Organization Roles¶

Get all roles under an organization structure.

Request Format¶

GET https://{apigw-address}/app-portal-service/v2.2/organization/role/list

Request Parameters (URI)¶

Name

Mandatory/Optional

Data Type

Description

orgId

Mandatory

String

The organization ID

locale

Optional

String

The language code. If unspecified, it is set to English by default

en_US for English

zh_CN for Chinese

es_ES for Spanish

ja_JP for Japanese

Response Parameters¶

Name	Data Type	Description
data	Data Struct	The list of roles

Data Struct¶

Name	Data Type	Description
roles	RoleDTO Struct List	The list of role structs

RoleDTO Struct¶

Name	Data Type	Description
id	String	The role ID
name	String	The role name

Error Codes¶

Code	Message	Description
31400	Lack of necessary parameters	Organization ID is required
31404	Can not find this organization	The organization does not exist

Samples¶

Request Sample¶

url: https://{apigw-address}/app-portal-service/v2.2/organization/role/list?orgId={your_org_id}&locale={locale}

method: GET

Return Sample¶

{
    "code":0,
    "data":{
        "roles":[
          {
            "id":"r133",
            "name":"name133"
          },
          {
            "id":"r134",
            "name":"name134"
          }
        ]
    },
    "message":""
}