役職設定

    ドメインで役職の使用有無を設定します。 役職を追加するには、使用有無を true に設定する必要があります。

    役職の使用を無効に変更すると、以前に登録された役職とメンバーに設定された役職に関する情報はすべて削除されます。

    API の種類

    サーバー API

    Request URL

    • サービス: https://apis.worksmobile.com/r/{API ID}/organization/v2/domains/{domainId}/positions/use
    • テスト: https://sandbox-apis.worksmobile.com/r/{API ID}/organization/v2/domains/{domainId}/positions/use

    HTTP Method

    PUT (Content-Type: application/json; charset=UTF-8)

    Request Body

    パラメーター タイプ 必須 説明
    usePosition Boolean Y 役職の使用有無。
    ● true: 有効
    ● false: 無効

    Request Example

    PUT https://apis.worksmobile.com/r/apiid/organization/v2/domains/123/positions/use

    {
    "usePosition" : true
}

    Response

    API 呼び出しに成功すると HTTP 200 コードを返します。

    Error code

    呼び出しに失敗するとエラーコードとエラーメッセージを返します。
    エラーコードは組織連携REST APIエラーコードを参照してください。