組織移動

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

    注意

    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エラーコードを参照してください。