組織を追加する
組織を追加します。
1 度に追加できる組織は、100 件までです。
CSV ファイルをインポートする API の詳細は、 組織情報をインポートする を参照してください。
URL
https://sample.cybozu.com/v1/organizations.json
HTTP メソッド
POST
必要なアクセス権
リクエスト
パラメーター
親子関係の構造をもつ組織を同時に追加する場合は、親となる組織の情報を先に指定してください。
パラメーター名 | 型 | 必須 | 説明 |
---|---|---|---|
organizations | 配列 | 必須 | 組織情報の一覧 |
organizations[].code | 文字列 | 必須 | 組織コード 128 文字以下で指定します。 空文字または空白文字のみは指定できません。 |
organizations[].name | 文字列 | 必須 | 組織名 128 文字以下で指定します。 空文字または空白文字のみは指定できません。 |
organizations[].localName | 文字列 | 省略可 | 別言語での表示名 128 文字以下で指定します。 |
organizations[].localNameLocale | 文字列 | 省略可 | 別言語での表示名(言語) 次の値を指定できます。
null を指定すると、
システムの初期値
|
organizations[].parentCode | 文字列 | 省略可 | 親組織のコード 親組織がルートの組織の場合には null を指定します。 |
organizations[].description | 文字列 | 省略可 | 説明 1,000 文字以下で指定します。 |
リクエストの例
ヘッダー
|
|
リクエストヘッダーの詳細は User API の共通仕様 を参照してください。
ボディ
|
|
レスポンス
|
|
サンプルコード
curl を使ったリクエスト
|
|
制限事項
-
組織の事前設定
で予約データが作成されている場合は、API を実行できません。
- cybozu.com 共通管理における次の操作と、API の実行を並行して行うことは推奨しません。
- 組織とユーザーの設定画面における、組織に対する各操作
- ファイルからの読み込み