초대 일괄 생성

초대 일괄 생성 (Bulk create invites)

Docker Hub 조직에서 이메일 또는 Docker ID로 여러 초대(invite)를 한 번에 만드는 작업이에요. 팀 소유자만 초대를 만들 수 있고, 이 작업은 조직 액세스 토큰(OAT)에서 발급된 bearer 토큰을 받아요.

출처: 문서

본문

POST 요청으로 이메일 또는 Docker ID 목록에 초대를 일괄 생성합니다. bearerAuth 인증이 필요해요. dry_run을 쓰면 실제 데이터 변경 없이 검증만 할 수 있어요.

헤더 파라미터

파라미터 위치 설명
X-Analytics-Client-Feature header 분석용 클라이언트 기능 식별자

요청 본문

  • invitees: 초대할 이메일 또는 Docker ID 목록
  • org: 조직 이름
  • role: 초대 대상 역할 (예: member)
  • team: 팀 이름 (예: owners)
  • dry_run: (선택) 검증만 수행하고 실제로는 변경하지 않음
{
  "dry_run": true,
  "invitees": [
    "invitee1DockerId",
    "[email protected]",
    "[email protected]"
  ],
  "org": "docker",
  "role": "member",
  "team": "owners"
}

오류 응답

  • 400: 잘못된 요청
  • 401: 인증 실패
  • 403: 권한 없음
  • 404: 대상을 찾을 수 없음

예시 요청

curl \
  --request POST \
  --header "Authorization: Bearer ***" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "dry_run": true,
  "invitees": [
    "invitee1DockerId",
    "[email protected]",
    "[email protected]"
  ],
  "org": "docker",
  "role": "member",
  "team": "owners"
}' \
  'https://hub.docker.com/v2/invites'

더 알아보기