--- id: "en/api-get-nd-api-enterprise-dep-role" title: "Get a list of department roles" language: "en" description: "GET /nd/api/enterprise/dep_role: Get the department role list interface description, including path, method, parameters and return information." canonical_url: "https://www.babel.cc/public/babelwiki/en/api-get-nd-api-enterprise-dep-role.html" markdown_url: "https://www.babel.cc/public/babelwiki/ai/en/api-get-nd-api-enterprise-dep-role.md" alternates: {"en": "https://www.babel.cc/public/babelwiki/ai/en/api-get-nd-api-enterprise-dep-role.md", "zh": "https://www.babel.cc/public/babelwiki/ai/zh/api-get-nd-api-enterprise-dep-role.md"} reading_note: "文档记录不等于当前部署能力;以实际版本、授权模块与配置为准。保留原文的可选、限制及待确认说明,勿补猜接口。 / Documentation is not a guarantee for every deployment. Preserve optional-module requirements, limitations and unresolved API contracts." --- # Get Department Roles | Property | Value | | --- | --- | | Method | `GET` | | Path | `/nd/api/enterprise/dep_role` | | Authentication | `Authorization: Bearer ` | Retrieves department roles within the authorized context. The source document does not list specific URL parameters; confirm enterprise and permission context against the token and deployment rules. ## Response Fields | Field | Type | Description | | --- | --- | --- | | `roles` | array | Source lists `id`, `enterpriseId`, `filePermission`, `managerPermission`, `default`, `nameEn`, `name` | | `code` | int | Business status | | Success indicator | boolean | Source spells this `sucess`, unlike `success` in other endpoints; verify the actual response before integration | The source repeats `filePermission`; it is shown once here. Do not invent undocumented permission-field schemas or enum values. Reading a role definition does not grant the caller that role. See [Get Token](https://www.babel.cc/public/babelwiki/en/api-post-api-token-do.html).