Create a department

This document is automatically generated based on https://github.com/authing/authing-docs-factory based on https://api-explorer.genauth.ai V3 API, and is consistent with API parameters and return results. If this document description is incorrect, please refer to V3 API.

Create a department by organization code, department name, parent department ID, and set various parameters.

Method name

ManagementClient.createDepartment

Request parameters

Name	Type	Required	Default value	Description	Sample value
metadata	object	yes	-	Metadata information
parentDepartmentId	string	yes	-	Parent department id, if it is the root department, pass root	6229c4deb3e4d8a20b6021ff
name	string	yes	-	Department name	Development Department
organizationCode	string	yes	-	Organization Code (organizationCode)	steamory
openDepartmentId	string	no	-	Custom department ID, used to store custom IDs	ou_7dab8a3d3cdccxxxxxx777c7ad535d62
description	string	no	-	Department description	Technical R&D Department
code	string	no	-	Department identification code	6229c4deb3e4d8a20b6021ff
isVirtualNode	boolean	no	-	Is it a virtual department?
i18n	<a DepartmentI18nDto	no	-	Multi-language settings	{"name":{"zh-CN":{"enabled":false,"value":"中文"},"en-US":{"enabled":false,"value":"English"}}}
customData	object	No	-	Extended field data of department	{"icon":"https://example.com/logo"}
departmentIdType	string	No	department_id	Type of parent department ID used in this call	department_id
postIdList	string[]	No	-	Post id list	["xxx"]
tenantId	string	No	-	Tenant ID	623c20b2a062aaaaf41b17da

Sample code

import { ManagementClient, Models } from "authing-node-sdk";

// Initialize ManagementClient
const managementClient = new ManagementClient({
  // Need to be replaced with your GenAuth Access Key ID
  accessKeyId: "GEN_AUTH_ACCESS_KEY_ID",
  // Need to be replaced with your GenAuth Access Key Secret
  accessKeySecret: "GEN_AUTH_ACCESS_KEY_SECRET",
  // If you are a private deployment customer, you need to set the GenAuth service domain name
  // host: 'https://api.your-authing-service.com'
});

(async () => {
  const result = await managementClient.createDepartment({
    organizationCode: "steamory",
    name: "Development Department",
    description: "Technical R&D Department",
    parentDepartmentId: "6229c4dxxxx4d8a20b6021ff",
    code: "develop",
    isVirtualNode: false,
    i18n: {
      name: {
        "zh-CN": {
          enabled: false,
          value: "Chinese name",
        },
        "en-US": {
          enabled: false,
          value: "English",
        },
        "zh-TW": {
          enabled: false,
          value: "zh-TW",
        },
        "ja-JP": {
          enabled: false,
          value: "ja-JP",
        },
      },
    },
    customData: {
      icon: "https://example.com/logo",
    },
    departmentIdType:
      Models.CreateDepartmentReqDto.departmentIdType.DEPARTMENT_ID,
  });

  console.log(JSON.stringify(result, null, 2));
})();

Request response

Type: DepartmentSingleRespDto

Name	Type	Description
statusCode	number	Business status code, which can be used to determine whether the operation is successful. 200 means success.
message	string	Description
apiCode	number	Segment error code, which can be used to get the specific error type (not returned for successful requests). For a detailed list of error codes, see: API Code List
requestId	string	Request ID. Returned when the request fails.
data	<a DepartmentDto	Response data

Sample result:

{
  "statusCode": 200,
  "message": "Operation successful",
  "requestId": "934108e5-9fbf-4d24-8da1-c330328abd6c",
  "data": {
    "organizationCode": "steamory",
    "departmentId": "60b49eb83fd80adb96f26e68",
    "createdAt": "2022-07-03T03:20:30.000Z",
    "updatedAt": "2022-07-03T03:20:30.000Z",
    "openDepartmentId": "ou_7dab8a3d3cdccxxxxxx777c7ad535d62",
    "name": "Development Department",
    "leaderUserIds": "[\"60b49eb83fd80adb96f26e68\"]",
    "description": "Technical R&D Department",
    "parentDepartmentId": "6229c4deb3e4d8a20b6021ff",
    "code": "6229c4deb3e4d8a20b6021ff",
    "parentDepartmentCode": "test",
    "membersCount": 11,
    "hasChildren": true,
    "i18n": {
      "name": {
        "zh-CN": {
          "enabled": false,
          "value": "Chinese"
        },
        "en-US": {
          "enabled": false,
          "value": "English"
        }
      }
    },
    "customData": {
      "icon": "https://example.com/logo"
    },
    "postIdList": "[\"xxx\"]",
    "status": "false",
    "allow": "[\"xxx\"]"
  }
}

Data structure

DepartmentI18nDto

Name	Type	Is it required	Description	Sample value
name		Yes	Multi-language support field Nested type: <a LangObject.	{"zh-CN":{"enabled":false,"value":"中文"},"en-US":{"enabled":false,"value":"English"}}

LangObject

Name	Type	Is it required?	Description	Example value
zh-CN		Yes	Multilingual Chinese content Nesting type: <a LangUnit.	{"enabled":false,"value":"中文"}
en-US		Yes	Multilingual English content Nested type: <a LangUnit.	{"enabled":false,"value":"English"}
zh-TW		Yes	Multilingual Traditional Chinese content Nesting type: <a LangUnit.	{"enabled":false,"value":"Traditional Chinese"}
ja-JP		Yes	Multilingual Japanese content Nested type: <a LangUnit.	{"enabled":false,"value":"日本语"}

LangUnit

Name	Type	Required	Description	Example value
enabled	boolean	Yes	Whether it is enabled. If enabled and the language is selected in the console, the content will be displayed. (off by default)
value	string	yes	multilingual content

DepartmentDto

Name	Type	Required	Description	Example value
organizationCode	string	Yes	Organization Code (organizationCode)	steamory
departmentId	string	Yes	Department system ID (automatically generated for the GenAuth system and cannot be modified)	60b49eb83fd80adb96f26e68
createdAt	string	Yes	Department creation time	2022-07-03T03:20:30.000Z
updatedAt	string	No	Modification time	2022-07-03T03:20:30.000Z
openDepartmentId	string	No	Custom department ID, used to store customized IDs	ou_7dab8a3d3cdccxxxxxx777c7ad535d62
name	string	Yes	Department name	Development Department
leaderUserIds	array	No	Department leader ID	["60b49eb83fd80adb96f26e68"]
description	string	No	Department description	Technical R&D Department
parentDepartmentId	string	Yes	Parent department id, if it is the root department, pass root	6229c4deb3e4d8a20b6021ff
code	string	No	Department identification code	6229c4deb3e4d8a20b6021ff
parentDepartmentCode	string	yes	parent department code	test
membersCount	number	Yes	Department headcount (only direct members included)	11
hasChildren	boolean	yes	whether to include sub-departments	true
isVirtualNode	boolean	No	Is it a virtual department?
i18n		No	Multi-language settings Nested type: <a DepartmentI18nDto.	{"name":{"zh-CN":{"enabled":false,"value":"中文"},"en-US":{"enabled":false,"value":"English"}}}
customData	object	No	Extended field data of department	{"icon":"https://example.com/logo"}
posts	array	No	Positions associated with department
postIdList	array	No	Position id list	["xxx"]
status	boolean	No	Department status	false
allow	string	No	Access restriction	["xxx"]

DepartmentI18nDto

Name	Type	Is it required	Description	Example value
name		Yes	Multi-language-supported field Nested type: <a LangObject.	{"zh-CN":{"enabled":false,"value":"中文"},"en-US":{"enabled":false,"value":"English"}}

LangObject

Name	Type	Is it required?	Description	Sample value
zh-CN		Yes	Multilingual Chinese content Nested type: <a LangUnit.	{"enabled":false,"value":"中文"}
en-US		Yes	Multilingual English content Nested type: <a LangUnit.	{"enabled":false,"value":"English"}
zh-TW		Yes	Multilingual Traditional Chinese content Nesting type: <a LangUnit.	{"enabled":false,"value":"繁體中文"}
ja-JP		Yes	Multilingual Japanese content Nesting type: <a LangUnit.	{"enabled":false,"value":"日本語"}

LangUnit

Name	Type	Is it required?	Description	Sample value
enabled	boolean	yes	Whether it is enabled. If enabled, and the console selects this language, the content will be displayed. (Default is off)
value	string	yes	Multilingual content