組織API

プラン: Free、Premium、Ultimate
提供形態: GitLab.com、GitLab Self-Managed
ステータス: 実験的機能

このAPIを使用してGitLabの組織を操作します。詳細については、organizationを参照してください。

組織を作成

この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。

新しい組織を作成します。

このエンドポイントは実験的機能であり、予告なく変更または削除される可能性があります。

POST /organizations

パラメータは以下のとおりです:

属性	型	必須	説明
`name`	文字列	はい	組織の名前
`path`	文字列	はい	組織のパス
`description`	文字列	いいえ	組織の説明
`avatar`	ファイル	いいえ	組織のアバター画像

リクエスト例:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
--form "name=New Organization" \
--form "path=new-org" \
--form "description=A new organization" \
--form "avatar=@/path/to/avatar.png" \
"https://gitlab.example.com/api/v4/organizations"

レスポンス例:

{
  "id": 42,
  "name": "New Organization",
  "path": "new-org",
  "description": "A new organization",
  "created_at": "2024-09-18T02:35:15.371Z",
  "updated_at": "2024-09-18T02:35:15.371Z",
  "web_url": "https://gitlab.example.com/-/organizations/new-org",
  "avatar_url": "https://gitlab.example.com/uploads/-/system/organizations/organization_detail/avatar/42/avatar.png"
}