組織の登録

POST/orgunits

組織を登録する。

注意

  • 組織追加/修正/移動 API は、1ドメインにつき必ずシングルスレッドで1秒に1回、順番通りに呼び出すことを推奨します。

Authorization

oauth2

Authorization Code OAuth Flow

Authorization URL - https://auth.worksmobile.com/oauth2/v2.0/authorize
Token URL - https://auth.worksmobile.com/oauth2/v2.0/token
Refresh URL - https://auth.worksmobile.com/oauth2/v2.0/token

Scope

directory
orgunit

HTTP Request

POSThttps://www.worksapis.com/v1.0/orgunits

Header Parameters

HeadertypeDescription
Authorizationstring

Bearer {token}


required
Content-Typestring

application/json


required
example : application/json

Request Body

PropertyTypeDescription
domainIdinteger

ドメインID


required
format : int32
orgUnitExternalKeystring

組織のExternalKey

「%」、「\」、「#」、「/」、「?」の特殊文字は利用不可。


maxLength : 100
nullable : true
orgUnitNamestring

組織名
許容される特殊文字: !@&()-_+[]{},./


required
maxLength : 100
i18nNamesarray (OrgUnitI18nName)

多言語名リスト

emailstring

組織メールアドレス(組織を更新する際は必須)

  • アドバンスト/ベーシック/プレミアムプランの場合、ID@ドメイン名
  • 他のプランの場合、ID@グループ名
  • 80字まで入力可能
  • localPartは64字まで入力可能

maxLength : 90
descriptionstring

組織説明


maxLength : 160
nullable : true
visibleboolean

組織の公開可否 (true/false)
上位組織が非公開の場合には、指定値に関わらず非公開の組織となる


default : true
parentOrgUnitIdstring

上位組織ID

  • 組織ID(orgUnitId)
  • 組織のExternalKey(externalKey:{orgUnitExternalKey})

nullable : true
displayOrderinteger

組織の表示順
組織を登録する場合のみ必須
組織を更新する場合は無効

A
└ A1 (A 基準 displayOrder 1)
└ A2 (A 基準 displayOrder 2)
B
└ B1 (B 基準 displayOrder 1)
└ B2 (B 基準 displayOrder 2)


minimum : 1
format : int32
aliasEmailsarray (string)

組織のサブメールアドレスのリスト(アドバンスト/ベーシック/プレミアムプランのみ登録可)


minItems : 0
maxItems : 20
canReceiveExternalMailboolean

外部メールの受信可否フラグ


default : false
useMessageboolean

チームトークルームの利用フラグ


default : false
useNoteboolean

チームノートの利用フラグ
チームトーク利用時のみ利用できる


default : false
useCalendarboolean

チームカレンダーの利用フラグ
チームトーク利用時のみ利用できる


default : false
useTaskboolean

チームタスクの利用フラグ
チームトーク利用時のみ利用可能


default : false
useFolderboolean

チームフォルダの利用フラグ
チームトーク利用時のみ利用できる


default : false
useServiceNotificationboolean

サービス通知送信フラグ


default : false
membersAllowedToUseOrgUnitEmailAsRecipientarray (OrgUnitAllowedMember)

組織メールアドレスでメールを受信可能なメンバーのリスト


minItems : 0
membersAllowedToUseOrgUnitEmailAsSenderarray (OrgUnitAllowedMember)

送信アドレスとして使用可能なメンバーのリスト


minItems : 0

OrgUnitI18nName

PropertyTypeDescription
languagestring

多言語コード


required
Allowed values : ja_JP, ko_KR, en_US, zh_CN, zh_TW
namestring

多言語名
許容される特殊文字: !@&()-_+[]{},./


required
maxLength : 100

OrgUnitAllowedMember

PropertyTypeDescription
userIdstring

ユーザーID(userId)


required

Request Example

example

1{
2  "domainId": 10000001,
3  "orgUnitExternalKey": "externalKeyValue",
4  "orgUnitName": "組織01",
5  "i18nNames": [
6    {
7      "language": "en_US",
8      "name": "Team01"
9    }
10  ],
11  "email": "team01@example.com",
12  "description": "desc",
13  "visible": true,
14  "parentOrgUnitId": "parernt9-ffda-4395-24a8-03fb9e22e051",
15  "displayOrder": 1,
16  "aliasEmails": [
17    "alias@example.com"
18  ],
19  "canReceiveExternalMail": true,
20  "useMessage": true,
21  "useNote": true,
22  "useCalendar": true,
23  "useFolder": true,
24  "useServiceNotification": true,
25  "membersAllowedToUseOrgUnitEmailAsRecipient": [
26    {
27      "userId": "e7b4f7da-f82c-4284-13e7-030f3b4c7569"
28    }
29  ],
30  "membersAllowedToUseOrgUnitEmailAsSender": [
31    {
32      "userId": "e7b4f7da-f82c-4284-13e7-030f3b4c7569"
33    }
34  ],
35  "displayLevel": 1
36}

Response

HTTP 201

OK

PropertyTypeDescription
domainIdinteger

ドメインID


required
format : int32
orgUnitIdstring

組織ID

  • 組織のリソースID
  • 登録時に自動発行されるユニークID

readOnly : true
orgUnitExternalKeystring

組織のExternalKey

「%」、「\」、「#」、「/」、「?」の特殊文字は利用不可。


maxLength : 100
nullable : true
orgUnitNamestring

組織名
許容される特殊文字: !@&()-_+[]{},./


required
maxLength : 100
i18nNamesarray (OrgUnitI18nName)

多言語名リスト

emailstring

組織メールアドレス(組織を更新する際は必須)

  • アドバンスト/ベーシック/プレミアムプランの場合、ID@ドメイン名
  • 他のプランの場合、ID@グループ名
  • 80字まで入力可能
  • localPartは64字まで入力可能

maxLength : 90
descriptionstring

組織説明


maxLength : 160
nullable : true
visibleboolean

組織公開フラグ


default : true
parentOrgUnitIdstring

上位組織ID

  • 組織ID(orgUnitId)
  • 組織のExternalKey(externalKey:{orgUnitExternalKey})

nullable : true
parentExternalKeystring

上位組織のExternalKey


readOnly : true
nullable : true
displayOrderinteger

組織の表示順
組織を登録する場合のみ必須
組織を更新する場合は無効

A
└ A1 (A 基準 displayOrder 1)
└ A2 (A 基準 displayOrder 2)
B
└ B1 (B 基準 displayOrder 1)
└ B2 (B 基準 displayOrder 2)


minimum : 1
format : int32
displayLevelinteger

組織の階層(depth, 1から開始)


minimum : 1
format : int32
readOnly : true
aliasEmailsarray (string)

組織のサブメールアドレスのリスト(アドバンスト/ベーシック/プレミアムプランのみ登録可)


minItems : 0
maxItems : 20
canReceiveExternalMailboolean

外部メールの受信可否フラグ


default : false
useMessageboolean

チームトークルームの利用フラグ


default : false
useNoteboolean

チームノートの利用フラグ
チームトーク利用時のみ利用できる


default : false
useCalendarboolean

チームカレンダーの利用フラグ
チームトーク利用時のみ利用できる


default : false
useTaskboolean

チームタスクの利用フラグ
チームトーク利用時のみ利用可能


default : false
useFolderboolean

チームフォルダの利用フラグ
チームトーク利用時のみ利用できる


default : false
useServiceNotificationboolean

サービス通知送信フラグ


default : false
membersAllowedToUseOrgUnitEmailAsRecipientarray (OrgUnitAllowedMember)

組織メールアドレス宛にメールを送信可能なメンバーのリスト


minItems : 0
membersAllowedToUseOrgUnitEmailAsSenderarray (OrgUnitAllowedMember)

組織メールアドレスを送信元としてメールを送信可能なメンバーのリスト
組織のメンバーのみを指定可能


minItems : 0

OrgUnitI18nName

PropertyTypeDescription
languagestring

多言語コード


required
Allowed values : ja_JP, ko_KR, en_US, zh_CN, zh_TW
namestring

多言語名
許容される特殊文字: !@&()-_+[]{},./


required
maxLength : 100

OrgUnitAllowedMember

PropertyTypeDescription
userIdstring

ユーザーID(userId)


required
userExternalKeystring

ユーザーのExternalKey


readOnly : true
nullable : true

Response Example

example

1{
2  "domainId": 10000001,
3  "orgUnitId": "orgunitf-f27f-4af8-27e1-03817a911417",
4  "orgUnitExternalKey": "externalKeyValue",
5  "orgUnitName": "組織01",
6  "i18nNames": [
7    {
8      "language": "en_US",
9      "name": "Team01"
10    }
11  ],
12  "email": "team01@example.com",
13  "description": "desc",
14  "visible": true,
15  "parentOrgUnitId": "parernt9-ffda-4395-24a8-03fb9e22e051",
16  "parentExternalKey": "parentExtKeyValue",
17  "displayOrder": 1,
18  "displayLevel": 1,
19  "aliasEmails": [
20    "alias@example.com"
21  ],
22  "canReceiveExternalMail": true,
23  "useMessage": true,
24  "useNote": true,
25  "useCalendar": true,
26  "useFolder": true,
27  "useServiceNotification": true,
28  "membersAllowedToUseOrgUnitEmailAsRecipient": [
29    {
30      "userId": "e7b4f7da-f82c-4284-13e7-030f3b4c7569",
31      "userExternalKey": null
32    }
33  ],
34  "membersAllowedToUseOrgUnitEmailAsSender": [
35    {
36      "userId": "e7b4f7da-f82c-4284-13e7-030f3b4c7569",
37      "userExternalKey": null
38    }
39  ]
40}

HTTP 400

Bad Request