組織移動

組織の並び順を変更します。

注意

組織追加/修正/移動 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エラーコードを参照してください。

LINE WORKS Developers