조직 API

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed Status: Experiment

조직 생성

  • GitLab 17.5에서 allow_organization_creation이라는 플래그로 도입되었습니다. 기본적으로 비활성화됩니다. 이 기능은 실험입니다.
이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 정보는 이력을 참조하세요.

새로운 조직을 생성합니다.

이 엔드포인트는 실험적이며 사전 통보 없이 변경되거나 제거될 수 있습니다.

POST /organizations

파라미터:

속성 유형 필수 설명
name string yes 조직의 이름
path string yes 조직의 경로
description string no 조직의 설명
avatar file no 조직을 위한 아바타 이미지

예시 요청:

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"
}