組織移動
組織の並び順を変更します。
注意
- 組織追加/修正/移動 API は、1ドメインにつき必ずシングルスレッドで1秒に1回、順番通りに呼び出すことを推奨します。
例) 5 番目の orgunit5 を parentOrgUnitの 2番目 (order) の位置に移動する時、
1 parentOrgUnit ---> 1 parentOrgUnit
2 orgunit1 2 orgunit1
3 orgunit2 5 orgunit5
4 orgunit3 3 orgunit2
4 orgunit3
API の種類
サーバー API
Request URL
https://apis.worksmobile.com/r/{API ID}/organization/v2/domains/{domainId}/orgunits/{externalKey}/move
HTTP Method
POST
Path Parameters
パラメーター | タイプ | 上限 | 必須 | 説明 |
---|---|---|---|---|
domainId | Integer | Y | ドメイン ID | |
externalKey | String | 100 字 | Y | 組織の External Key |
Request Parameters
パラメーター | タイプ | 上限 | 必須 | 説明 |
---|---|---|---|---|
parentExternalKey | String | 100 字 | N | 移動する上位組織の External Key。 最上位組織の場合、空 (null) または 0 を入力する。 |
order | Integer | Y | ある組織に属する下位組織の整列順 |
Request Example
POST https://apis.worksmobile.comr/r/apiid/organization/v2/domains/123/orgunits/EX123/move
{
"parentExternalKey" : "ABC123",
"order" : 2
}
Response
API 呼び出しに成功すると HTTP 200 コードを返します。
Error Code
呼び出しに失敗するとエラーコードとエラーメッセージを返します。
エラーコードは組織連携REST APIエラーコードを参照してください。