조직 API
GitLab v19.2Offering: GitLab.com, GitLab Self-Managed
이 API를 사용하여 GitLab 조직과 상호작용합니다. 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 이 엔드포인트는 실험 단계이며 사전 공지 없이 변경되거나 제거될 수 있습니다. 조직을 소프트 삭제합니다. 성공하면 202 Accepted를 반환합니다.
이 API를 사용하여 GitLab 조직과 상호작용합니다. 자세한 내용은 조직을 참조하세요.
조직 생성#
히스토리
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조하세요.
조직을 생성합니다.
이 엔드포인트는 실험 단계이며 사전 공지 없이 변경되거나 제거될 수 있습니다.
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,
"uuid": "0192f8c2-1a2b-7cde-89ab-0123456789ab",
"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/o/new-org/-/overview",
"avatar_url": "https://gitlab.example.com/uploads/-/system/organizations/organization_detail/avatar/42/avatar.png"
}
조직 소프트 삭제#
조직을 소프트 삭제합니다. 조직은 비어 있어야 하며(그룹 또는 프로젝트가 없어야 함) 기본 조직이 아니어야 합니다. 조직 소유자와 관리자만 조직을 소프트 삭제할 수 있습니다.
이 엔드포인트는 실험 단계이며 사전 공지 없이 변경되거나 제거될 수 있습니다.
DELETE /organizations/:id
매개변수:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 | 예 | 조직의 ID |
요청 예시:
curl --request DELETE \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/organizations/42"
성공하면 202 Accepted를 반환합니다.