이 API를 사용하여 GitLab의 사용자 계정과 상호작용합니다. 이 엔드포인트로 내 계정 또는 다른 사용자의 계정을 관리할 수 있습니다.

모든 사용자 목록 조회#

모든 사용자를 조회합니다.

사용자 목록을 제한하려면 페이지네이션 파라미터인 page와 per_page를 사용합니다.

일반 사용자로 조회#

히스토리

• GitLab 18.2에서 saml_provider_id 속성이 제거되었습니다.

GET /users

지원되는 속성:

응답 예시:

[
  {
    "id": 1,
    "username": "john_smith",
    "name": "John Smith",
    "state": "active",
    "locked": false,
    "avatar_url": "http://localhost:3000/uploads/user/avatar/1/cd8.jpeg",
    "web_url": "http://localhost:3000/john_smith"
  },
  {
    "id": 2,
    "username": "jack_smith",
    "name": "Jack Smith",
    "state": "blocked",
    "locked": false,
    "avatar_url": "http://gravatar.com/../e32131cd8.jpeg",
    "web_url": "http://localhost:3000/jack_smith"
  }
]

이 엔드포인트는 키셋 페이지네이션을 지원합니다. GitLab 17.0 이상에서는 응답이 50,000건 이상이면 키셋 페이지네이션이 필수입니다.

?search=를 사용하여 이름, username 또는 공개 이메일로 사용자를 검색할 수도 있습니다. 예를 들어 /users?search=John과 같이 사용합니다. 검색 대상이 다음과 같을 때의 동작은 이렇습니다.

• 공개 이메일로 검색할 때는 정확히 일치하는 결과를 얻으려면 전체 이메일 주소를 사용해야 합니다.
• 이름 또는 username으로 검색할 때는 퍼지 검색이므로 정확히 일치하지 않아도 됩니다.

또한 username으로 사용자를 조회할 수 있습니다.

GET /users?username=:username

예를 들면 다음과 같습니다.

GET /users?username=jack_smith

또한 blocked와 active 상태를 기준으로 사용자를 필터링할 수 있습니다. active=false 또는 blocked=false는 지원하지 않습니다.

GET /users?active=true

GET /users?blocked=true

또한 external=true를 사용하여 외부 사용자만 검색할 수 있습니다. external=false는 지원하지 않습니다.

GET /users?external=true

GitLab은 알림 봇이나 지원 봇과 같은 봇 사용자를 지원합니다. exclude_internal=true 파라미터를 사용하여 사용자 목록에서 다음 유형의 내부 사용자를 제외할 수 있습니다.

• 알림 봇
• 지원 봇

그러나 이 작업은 프로젝트용 봇 사용자나 그룹용 봇 사용자는 제외하지 않습니다.

GET /users?exclude_internal=true

또한 사용자 목록에서 외부 사용자를 제외하려면 exclude_external=true 파라미터를 사용할 수 있습니다.

GET /users?exclude_external=true

프로젝트용 봇 사용자와 그룹용 봇 사용자를 제외하려면 without_project_bots=true 파라미터를 사용할 수 있습니다.

GET /users?without_project_bots=true

관리자로 조회#

히스토리

• GitLab 18.3에서 응답의 email_reset_offered_at 필드가 제거되었습니다.
• GitLab 19.3에서 응답에 provisioned_by_project_id 필드가 추가되었습니다.

GET /users

모든 사용자가 사용할 수 있는 파라미터와 관리자만 사용할 수 있는 다음 추가 속성을 모두 사용할 수 있습니다.

지원되는 속성:

응답 예시:

[
  {
    "id": 1,
    "username": "john_smith",
    "email": "john@example.com",
    "name": "John Smith",
    "state": "active",
    "locked": false,
    "avatar_url": "http://localhost:3000/uploads/user/avatar/1/index.jpg",
    "web_url": "http://localhost:3000/john_smith",
    "created_at": "2012-05-23T08:00:58Z",
    "is_admin": false,
    "bio": "",
    "location": null,
    "linkedin": "",
    "twitter": "",
    "discord": "",
    "github": "",
    "website_url": "",
    "organization": "",
    "job_title": "",
    "last_sign_in_at": "2012-06-01T11:41:01Z",
    "confirmed_at": "2012-05-23T09:05:22Z",
    "theme_id": 1,
    "last_activity_on": "2012-05-23",
    "color_scheme_id": 2,
    "projects_limit": 100,
    "current_sign_in_at": "2012-06-02T06:36:55Z",
    "note": "DMCA Request: 2018-11-05 | DMCA Violation | Abuse | https://gitlab.zendesk.com/agent/tickets/123",
    "identities": [
      {"provider": "github", "extern_uid": "2435223452345"},
      {"provider": "bitbucket", "extern_uid": "john.smith"},
      {"provider": "google_oauth2", "extern_uid": "8776128412476123468721346"}
    ],
    "can_create_group": true,
    "can_create_project": true,
    "two_factor_enabled": true,
    "external": false,
    "private_profile": false,
    "current_sign_in_ip": "196.165.1.102",
    "last_sign_in_ip": "172.127.2.22",
    "namespace_id": 1,
    "provisioned_by_project_id": null,
    "created_by": null
  },
  {
    "id": 2,
    "username": "jack_smith",
    "email": "jack@example.com",
    "name": "Jack Smith",
    "state": "blocked",
    "locked": false,
    "avatar_url": "http://localhost:3000/uploads/user/avatar/2/index.jpg",
    "web_url": "http://localhost:3000/jack_smith",
    "created_at": "2012-05-23T08:01:01Z",
    "is_admin": false,
    "bio": "",
    "location": null,
    "linkedin": "",
    "twitter": "",
    "discord": "",
    "github": "",
    "website_url": "",
    "organization": "",
    "job_title": "",
    "last_sign_in_at": null,
    "confirmed_at": "2012-05-30T16:53:06.148Z",
    "theme_id": 1,
    "last_activity_on": "2012-05-23",
    "color_scheme_id": 3,
    "projects_limit": 100,
    "current_sign_in_at": "2014-03-19T17:54:13Z",
    "identities": [],
    "can_create_group": true,
    "can_create_project": true,
    "two_factor_enabled": true,
    "external": false,
    "private_profile": false,
    "current_sign_in_ip": "10.165.1.102",
    "last_sign_in_ip": "172.127.2.22",
    "namespace_id": 2,
    "provisioned_by_project_id": null,
    "created_by": null
  }
]

GitLab Premium 또는 Ultimate 사용자에게는 shared_runners_minutes_limit, extra_shared_runners_minutes_limit, is_auditor, using_license_seat 파라미터도 표시됩니다.

[
  {
    "id": 1,
    ...
    "shared_runners_minutes_limit": 133,
    "extra_shared_runners_minutes_limit": 133,
    "is_auditor": false,
    "using_license_seat": true
    ...
  }
]

GitLab Premium 또는 Ultimate 사용자에게는 group_saml 공급자 옵션과 provisioned_by_group_id 파라미터도 표시됩니다.

[
  {
    "id": 1,
    ...
    "identities": [
      {"provider": "github", "extern_uid": "2435223452345"},
      {"provider": "bitbucket", "extern_uid": "john.smith"},
      {"provider": "google_oauth2", "extern_uid": "8776128412476123468721346"},
      {"provider": "group_saml", "extern_uid": "123789", "saml_provider_id": 10}
    ],
    "provisioned_by_group_id": 123789
    ...
  }
]

?search=를 사용하여 이름, username 또는 이메일로 사용자를 검색할 수도 있습니다. 예를 들어 /users?search=John과 같이 사용합니다. 검색 대상이 다음과 같을 때의 동작은 이렇습니다.

• 이메일로 검색할 때는 정확히 일치하는 결과를 얻으려면 전체 이메일 주소를 사용해야 합니다. 관리자는 공개 이메일 주소와 비공개 이메일 주소를 모두 검색할 수 있습니다.
• 이름 또는 username으로 검색할 때는 퍼지 검색이므로 정확히 일치하지 않아도 됩니다.

외부 UID와 공급자로 사용자를 조회할 수 있습니다.

GET /users?extern_uid=:extern_uid&provider=:provider

예를 들면 다음과 같습니다.

GET /users?extern_uid=1234567&provider=github

GitLab Premium 또는 Ultimate 사용자는 scim 공급자를 사용할 수 있습니다.

GET /users?extern_uid=1234567&provider=scim

생성 일시 범위로 사용자를 검색할 수 있습니다.

GET /users?created_before=2001-01-02T00:00:00.060Z&created_after=1999-01-02T00:00:00.060

/users?without_projects=true를 사용하여 프로젝트가 없는 사용자를 검색할 수 있습니다.

사용자 지정 속성으로 필터링할 수 있습니다.

GET /users?custom_attributes[key]=value&custom_attributes[other_key]=other_value

응답에 사용자의 사용자 지정 속성을 포함할 수 있습니다.

GET /users?with_custom_attributes=true

created_by 파라미터를 사용하여 사용자 계정이 다음과 같이 생성되었는지 확인할 수 있습니다.

• 관리자가 수동으로 생성.
• 프로젝트 봇 사용자로 생성.

반환된 값이 null 이면 해당 계정은 사용자가 직접 등록하여 생성한 것입니다.

단일 사용자 조회#

단일 사용자를 조회합니다.

일반 사용자로 단일 사용자 조회#

일반 사용자로 단일 사용자를 조회합니다.

사전 요구 사항:

• 이 엔드포인트를 사용하려면 로그인되어 있어야 합니다.

GET /users/:id

지원되는 속성:

응답 예시:

{
  "id": 1,
  "username": "john_smith",
  "name": "John Smith",
  "state": "active",
  "locked": false,
  "avatar_url": "http://localhost:3000/uploads/user/avatar/1/cd8.jpeg",
  "web_url": "http://localhost:3000/john_smith",
  "created_at": "2012-05-23T08:00:58Z",
  "bio": "",
  "bio_html": "",
  "bot": false,
  "location": null,
  "public_email": "john@example.com",
  "linkedin": "",
  "twitter": "",
  "discord": "",
  "github": "",
  "website_url": "",
  "organization": "",
  "job_title": "Operations Specialist",
  "pronouns": "he/him",
  "work_information": null,
  "followers": 1,
  "following": 1,
  "local_time": "3:38 PM",
  "is_followed": false
}

관리자로 조회#

히스토리

• GitLab 18.3에서 응답의 email_reset_offered_at 필드가 제거되었습니다.

관리자로 단일 사용자를 조회합니다.

GET /users/:id

지원되는 속성:

응답 예시:

{
  "id": 1,
  "username": "john_smith",
  "email": "john@example.com",
  "name": "John Smith",
  "state": "active",
  "locked": false,
  "avatar_url": "http://localhost:3000/uploads/user/avatar/1/index.jpg",
  "web_url": "http://localhost:3000/john_smith",
  "created_at": "2012-05-23T08:00:58Z",
  "is_admin": false,
  "bio": "",
  "bio_html": "",
  "location": null,
  "public_email": "john@example.com",
  "linkedin": "",
  "twitter": "",
  "discord": "",
  "github": "",
  "website_url": "",
  "organization": "",
  "job_title": "Operations Specialist",
  "pronouns": "he/him",
  "work_information": null,
  "followers": 1,
  "following": 1,
  "local_time": "3:38 PM",
  "last_sign_in_at": "2012-06-01T11:41:01Z",
  "confirmed_at": "2012-05-23T09:05:22Z",
  "theme_id": 1,
  "last_activity_on": "2012-05-23",
  "color_scheme_id": 2,
  "projects_limit": 100,
  "current_sign_in_at": "2012-06-02T06:36:55Z",
  "note": "DMCA Request: 2018-11-05 | DMCA Violation | Abuse | https://gitlab.zendesk.com/agent/tickets/123",
  "identities": [
    {"provider": "github", "extern_uid": "2435223452345"},
    {"provider": "bitbucket", "extern_uid": "john.smith"},
    {"provider": "google_oauth2", "extern_uid": "8776128412476123468721346"}
  ],
  "can_create_group": true,
  "can_create_project": true,
  "two_factor_enabled": true,
  "external": false,
  "private_profile": false,
  "commit_email": "john-codes@example.com",
  "current_sign_in_ip": "196.165.1.102",
  "last_sign_in_ip": "172.127.2.22",
  "plan": "gold",
  "trial": true,
  "sign_in_count": 1337,
  "namespace_id": 1,
  "provisioned_by_project_id": null,
  "created_by": null
}

GitLab Premium 또는 Ultimate 사용자에게는 shared_runners_minutes_limit, is_auditor, extra_shared_runners_minutes_limit 파라미터도 표시됩니다.

{
  "id": 1,
  "username": "john_smith",
  "is_auditor": false,
  "shared_runners_minutes_limit": 133,
  "extra_shared_runners_minutes_limit": 133,
  ...
}

GitLab.com Premium 또는 Ultimate 사용자에게는 group_saml 옵션과 provisioned_by_group_id 파라미터도 표시됩니다.

{
  "id": 1,
  "username": "john_smith",
  "shared_runners_minutes_limit": 133,
  "extra_shared_runners_minutes_limit": 133,
  "identities": [
    {"provider": "github", "extern_uid": "2435223452345"},
    {"provider": "bitbucket", "extern_uid": "john.smith"},
    {"provider": "google_oauth2", "extern_uid": "8776128412476123468721346"},
    {"provider": "group_saml", "extern_uid": "123789", "saml_provider_id": 10}
  ],
  "provisioned_by_group_id": 123789
  ...
}

GitLab.com Premium 또는 Ultimate 사용자에게는 scim_identities 파라미터도 표시됩니다.

{
  ...
  "extra_shared_runners_minutes_limit": null,
  "scim_identities": [
      {"extern_uid": "2435223452345", "group_id": "3", "active": true},
      {"extern_uid": "john.smith", "group_id": "42", "active": false}
    ]
  ...
}

관리자는 created_by 파라미터를 사용하여 사용자 계정이 다음과 같이 생성되었는지 확인할 수 있습니다.

• 관리자가 수동으로 생성.
• 프로젝트 봇 사용자로 생성.

반환된 값이 null 이면 해당 계정은 사용자가 직접 등록하여 생성한 것입니다.

응답에 사용자의 사용자 지정 속성을 포함할 수 있습니다.

GET /users/:id?with_custom_attributes=true

현재 사용자 조회#

현재 사용자를 조회합니다.

일반 사용자로 조회#

내 사용자 상세 정보를 조회합니다.

GET /user

응답 예시:

{
  "id": 1,
  "username": "john_smith",
  "email": "john@example.com",
  "name": "John Smith",
  "state": "active",
  "locked": false,
  "avatar_url": "http://localhost:3000/uploads/user/avatar/1/index.jpg",
  "web_url": "http://localhost:3000/john_smith",
  "created_at": "2012-05-23T08:00:58Z",
  "bio": "",
  "location": null,
  "public_email": "john@example.com",
  "linkedin": "",
  "twitter": "",
  "discord": "",
  "github": "",
  "website_url": "",
  "organization": "",
  "job_title": "",
  "pronouns": "he/him",
  "bot": false,
  "work_information": null,
  "followers": 0,
  "following": 0,
  "local_time": "3:38 PM",
  "last_sign_in_at": "2012-06-01T11:41:01Z",
  "confirmed_at": "2012-05-23T09:05:22Z",
  "theme_id": 1,
  "last_activity_on": "2012-05-23",
  "color_scheme_id": 2,
  "projects_limit": 100,
  "current_sign_in_at": "2012-06-02T06:36:55Z",
  "identities": [
    {"provider": "github", "extern_uid": "2435223452345"},
    {"provider": "bitbucket", "extern_uid": "john_smith"},
    {"provider": "google_oauth2", "extern_uid": "8776128412476123468721346"}
  ],
  "can_create_group": true,
  "can_create_project": true,
  "two_factor_enabled": true,
  "external": false,
  "private_profile": false,
  "commit_email": "admin@example.com",
  "preferred_language": "en",
}

GitLab Premium 또는 Ultimate 사용자에게는 shared_runners_minutes_limit, extra_shared_runners_minutes_limit 파라미터도 표시됩니다.

관리자로 조회#

히스토리

• GitLab 18.3에서 응답의 email_reset_offered_at 필드가 제거되었습니다.

내 사용자 상세 정보 또는 다른 사용자의 상세 정보를 조회합니다.

GET /user

지원되는 속성:

{
  "id": 1,
  "username": "john_smith",
  "email": "john@example.com",
  "name": "John Smith",
  "state": "active",
  "locked": false,
  "avatar_url": "http://localhost:3000/uploads/user/avatar/1/index.jpg",
  "web_url": "http://localhost:3000/john_smith",
  "created_at": "2012-05-23T08:00:58Z",
  "is_admin": true,
  "bio": "",
  "location": null,
  "public_email": "john@example.com",
  "linkedin": "",
  "twitter": "",
  "discord": "",
  "github": "",
  "website_url": "",
  "organization": "",
  "job_title": "",
  "last_sign_in_at": "2012-06-01T11:41:01Z",
  "confirmed_at": "2012-05-23T09:05:22Z",
  "theme_id": 1,
  "last_activity_on": "2012-05-23",
  "color_scheme_id": 2,
  "projects_limit": 100,
  "current_sign_in_at": "2012-06-02T06:36:55Z",
  "identities": [
    {"provider": "github", "extern_uid": "2435223452345"},
    {"provider": "bitbucket", "extern_uid": "john_smith"},
    {"provider": "google_oauth2", "extern_uid": "8776128412476123468721346"}
  ],
  "can_create_group": true,
  "can_create_project": true,
  "two_factor_enabled": true,
  "external": false,
  "private_profile": false,
  "commit_email": "john-codes@example.com",
  "current_sign_in_ip": "196.165.1.102",
  "last_sign_in_ip": "172.127.2.22",
  "namespace_id": 1,
  "provisioned_by_project_id": null,
  "created_by": null,
  "note": null
}

GitLab Premium 또는 Ultimate 사용자에게는 다음 파라미터도 표시됩니다.

• shared_runners_minutes_limit
• extra_shared_runners_minutes_limit
• is_auditor
• provisioned_by_group_id
• using_license_seat

사용자 생성#

사용자를 생성합니다.

사전 요구 사항:

• 관리자여야 합니다.

POST /users

지원되는 속성:

사용자 수정#

기존 사용자를 수정합니다.

사전 요구 사항:

• 관리자여야 합니다.

email 필드는 사용자의 기본 이메일 주소입니다. 이 필드는 해당 사용자에게 이미 추가된 보조 이메일 주소로만 변경할 수 있습니다. 동일한 사용자에게 이메일 주소를 더 추가하려면 이메일 추가 엔드포인트를 사용합니다.

PUT /users/:id

지원되는 속성:

사용자의 비밀번호를 업데이트하면 해당 사용자는 다음 로그인 시 비밀번호를 변경해야 합니다.

409(Conflict)가 더 적절한 경우에도 404 오류를 반환합니다. 예를 들어 이메일 주소를 이미 존재하는 주소로 변경하는 경우가 이에 해당합니다.

사용자 삭제#

사용자를 삭제합니다.

사전 요구 사항:

• 관리자여야 합니다.

반환 값은 다음과 같습니다.

• 작업이 성공하면 204 No Content 상태 코드를 반환합니다.
• 리소스를 찾을 수 없으면 404를 반환합니다.
• 사용자를 소프트 삭제할 수 없으면 409를 반환합니다.

DELETE /users/:id

지원되는 속성:

내 사용자 상태 조회#

내 사용자 상태를 조회합니다.

사전 요구 사항:

• 본인 인증이 되어 있어야 합니다.

GET /user/status

요청 예시:

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/user/status"

응답 예시:

{
  "emoji":"coffee",
  "availability":"busy",
  "message":"I crave coffee :coffee:",
  "message_html": "I crave coffee <gl-emoji title=\"hot beverage\" data-name=\"coffee\" data-unicode-version=\"4.0\">☕</gl-emoji>",
  "clear_status_at": null
}

사용자 상태 조회#

사용자의 상태를 조회합니다. 이 엔드포인트는 인증 없이 사용할 수 있습니다.

GET /users/:id_or_username/status

지원되는 속성:

요청 예시:

curl --request GET \
  --url "https://gitlab.example.com/users/<username>/status"

응답 예시:

{
  "emoji":"coffee",
  "availability":"busy",
  "message":"I crave coffee :coffee:",
  "message_html": "I crave coffee <gl-emoji title=\"hot beverage\" data-name=\"coffee\" data-unicode-version=\"4.0\">☕</gl-emoji>",
  "clear_status_at": null
}

내 사용자 상태 설정#

내 사용자 상태를 설정합니다.

사전 요구 사항:

• 본인 인증이 되어 있어야 합니다.

PUT /user/status
PATCH /user/status

지원되는 속성:

PUT과 PATCH의 차이는 다음과 같습니다.

• PUT을 사용하면 전달하지 않은 파라미터는 null로 설정되어 값이 지워집니다.
• PATCH를 사용하면 전달하지 않은 파라미터는 무시됩니다. 필드를 지우려면 null을 명시적으로 전달합니다.

요청 예시:

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/user/status" \
  --data "clear_status_after=1_day" \
  --data "emoji=coffee" \
  --data "message=I crave coffee" \
  --data "availability=busy"

응답 예시:

{
  "emoji":"coffee",
  "availability":"busy",
  "message":"I crave coffee",
  "message_html": "I crave coffee",
  "clear_status_at":"2021-02-15T10:49:01.311Z"
}

내 사용자 환경 설정 조회#

내 사용자 환경 설정을 조회합니다.

사전 요구 사항:

• 본인 인증이 되어 있어야 합니다.

GET /user/preferences

응답 예시:

{
  "id": 1,
  "user_id": 1,
  "view_diffs_file_by_file": true,
  "show_whitespace_in_diffs": false,
  "pass_user_identities_to_ci_jwt": false
}

내 사용자 환경 설정 업데이트#

내 사용자 환경 설정을 업데이트합니다.

사전 요구 사항:

• 본인 인증이 되어 있어야 합니다.

PUT /user/preferences

{
  "id": 1,
  "user_id": 1,
  "view_diffs_file_by_file": true,
  "show_whitespace_in_diffs": false,
  "pass_user_identities_to_ci_jwt": false
}

지원되는 속성:

내 아바타 업로드#

히스토리

• GitLab 17.0에서 추가되었습니다.

내 아바타를 업로드합니다.

사전 요구 사항:

• 본인 인증이 되어 있어야 합니다.
• 파일 크기는 200KB 이하여야 합니다. 권장 이미지 크기는 192 x 192 픽셀입니다.
• 이미지는 다음 파일 형식 중 하나여야 합니다.
  • .bmp
  • .gif
  • .ico
  • .jpeg
  • .png
  • .tiff

PUT /user/avatar

지원되는 속성:

파일 시스템에서 아바타를 업로드하려면 --form 인수를 사용합니다. 이 인수를 사용하면 cURL이 Content-Type: multipart/form-data 헤더로 데이터를 전송합니다. avatar= 파라미터는 파일 시스템의 이미지 파일을 가리켜야 하며 앞에 @를 붙여야 합니다.

요청 예시:

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/user/avatar" \
  --form "avatar=@/path/to/your/avatar.png"

응답 예시:

{
  "avatar_url": "http://gitlab.example.com/uploads/-/system/user/avatar/76/avatar.png",
}

반환 값은 다음과 같습니다.

• 성공하면 200을 반환합니다.
• 파일 크기가 200KiB를 초과하면 400 Bad Request를 반환합니다.

할당된 이슈, 머지 리퀘스트, 리뷰 수 조회#

나에게 할당된 이슈, 머지 리퀘스트, 리뷰의 수를 조회합니다.

사전 요구 사항:

• 본인 인증이 되어 있어야 합니다.

지원되는 속성:

GET /user_counts

요청 예시:

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/user_counts"

응답 예시:

{
  "merge_requests": 4,
  "assigned_issues": 15,
  "assigned_merge_requests": 11,
  "review_requested_merge_requests": 0,
  "todos": 1
}

사용자의 프로젝트, 그룹, 이슈, 머지 리퀘스트 수 조회#

사용자의 다음 항목 수를 조회합니다.

• 프로젝트.
• 그룹.
• 이슈.
• 머지 리퀘스트.

관리자는 모든 사용자를 조회할 수 있지만, 관리자가 아닌 사용자는 자신만 조회할 수 있습니다.

GET /users/:id/associations_count

지원되는 속성:

응답 예시:

{
  "groups_count": 2,
  "projects_count": 3,
  "issues_count": 8,
  "merge_requests_count": 5
}

사용자 활동 목록 조회#

사전 요구 사항:

• 비공개 프로필 사용자의 활동을 보려면 관리자여야 합니다.

공개 프로필 사용자의 마지막 활동 날짜를 오래된 순에서 최신 순으로 정렬하여 가져옵니다.

사용자 이벤트 타임스탬프(last_activity_on 및 current_sign_in_at)를 갱신하는 활동은 다음과 같습니다.

• Git HTTP/SSH 활동(clone, push 등)
• 사용자의 GitLab 로그인
• 사용자의 대시보드, 프로젝트, 이슈, 머지 리퀘스트 관련 페이지 방문
• 사용자의 API 사용
• 사용자의 GraphQL API 사용

기본적으로 최근 6개월 동안의 공개 프로필 사용자 활동을 표시하며, from 파라미터를 사용하여 이 범위를 조정할 수 있습니다.

GET /user/activities

지원되는 속성:

요청 예시:

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/user/activities"

응답 예시:

[
  {
    "username": "user1",
    "last_activity_on": "2015-12-14",
    "last_activity_at": "2015-12-14"
  },
  {
    "username": "user2",
    "last_activity_on": "2015-12-15",
    "last_activity_at": "2015-12-15"
  },
  {
    "username": "user3",
    "last_activity_on": "2015-12-16",
    "last_activity_at": "2015-12-16"
  }
]

last_activity_at은 사용 중단되었습니다. 대신 last_activity_on을 사용합니다.

사용자가 멤버로 있는 프로젝트 및 그룹 목록 조회#

사전 요구 사항:

• 관리자여야 합니다.

사용자가 멤버로 있는 모든 프로젝트와 그룹을 조회합니다.

멤버십의 source_id, source_name, source_type, access_level을 반환합니다. 소스는 Namespace(그룹을 의미) 또는 Project 유형입니다. 응답에는 직접 멤버십만 표시됩니다. 예를 들어 하위 그룹에서 상속된 멤버십은 포함되지 않습니다. 액세스 수준은 정수 값으로 표현됩니다.

• 0: 액세스 없음
• 5: 최소 액세스
• 10: Guest
• 15: Planner
• 20: Reporter
• 30: Developer
• 40: Maintainer
• 50: Owner

GET /users/:id/memberships

지원되는 속성:

요청 예시:

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/users/:user_id/memberships"

응답 예시:

[
  {
    "source_id": 1,
    "source_name": "Project one",
    "source_type": "Project",
    "access_level": "20"
  },
  {
    "source_id": 3,
    "source_name": "Group three",
    "source_type": "Namespace",
    "access_level": "20"
  }
]

반환 값은 다음과 같습니다.

• 성공하면 200 OK를 반환합니다.
• 사용자를 찾을 수 없으면 404 User Not Found를 반환합니다.
• 관리자가 요청하지 않았으면 403 Forbidden을 반환합니다.
• 요청한 유형이 지원되지 않으면 400 Bad Request를 반환합니다.

사용자의 이중 인증 비활성화#

사전 요구 사항:

• 관리자여야 합니다.

지정한 사용자의 이중 인증(2FA)을 비활성화합니다.

관리자는 API로 자신의 사용자 계정이나 다른 관리자의 2FA를 비활성화할 수 없습니다. 대신 Rails 콘솔을 사용하여 관리자의 2FA를 비활성화할 수 있습니다.

PATCH /users/:id/disable_two_factor

지원되는 속성:

요청 예시:

curl --request PATCH \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/users/1/disable_two_factor"

반환 값은 다음과 같습니다.

• 성공하면 204 No content를 반환합니다.
• 지정한 사용자에게 이중 인증이 활성화되어 있지 않으면 400 Bad request를 반환합니다.
• 관리자로 인증되지 않았으면 403 Forbidden을 반환합니다.
• 사용자를 찾을 수 없으면 404 User Not Found를 반환합니다.

사용자와 연결된 러너 생성#

현재 사용자와 연결된 러너를 생성합니다. 감사 목적으로 해당 사용자가 소유자로 표시되지만, 러너의 가용 범위는 runner_type에 따라 결정됩니다. 자세한 내용은 러너 관리를 참고합니다.

사전 요구 사항:

• 관리자이거나 대상 네임스페이스 또는 프로젝트에 대해 Owner 권한이 있어야 합니다.
• instance_type의 경우 GitLab 인스턴스의 관리자여야 합니다.
• Owner 권한으로 group_type 또는 project_type을 사용하려면 러너 등록이 허용되어 있어야 합니다.
• create_runner 스코프를 가진 액세스 토큰이 필요합니다.

응답의 token은 반드시 복사하거나 저장합니다. 이 값은 다시 조회할 수 없습니다.

POST /user/runners

지원되는 속성:

요청 예시:

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/user/runners" \
  --data "runner_type=instance_type"

응답 예시:

{
    "id": 9171,
    "token": "<access-token>",
    "token_expires_at": null
}

사용자로부터 인증 ID 삭제#

해당 ID에 연결된 공급자 이름을 사용하여 사용자의 인증 ID를 삭제합니다.

사전 요구 사항:

• 관리자여야 합니다.

DELETE /users/:id/identities/:provider

지원되는 속성:

지원 PIN 생성#

히스토리

• GitLab 17.8에서 도입되었습니다.

내 사용자 계정에 대한 지원 PIN을 생성합니다. PIN은 생성 후 7일이 지나면 만료됩니다. GitLab 지원팀이 신원 확인을 위해 이 PIN을 요청할 수 있습니다.

사전 요구 사항:

• 본인 인증이 되어 있어야 합니다.

POST /user/support_pin

요청 예시:

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/user/support_pin"

응답 예시:

{
  "pin":"123456",
  "expires_at":"2025-02-27T22:06:57Z"
}

지원 PIN 상세 정보 조회#

히스토리

• GitLab 17.8에서 도입되었습니다.

내 계정의 지원 PIN에 대한 상세 정보를 조회합니다. GitLab 지원팀이 신원 확인을 위해 이 PIN을 요청할 수 있습니다.

사전 요구 사항:

• 본인 인증이 되어 있어야 합니다.

GET /user/support_pin

요청 예시:

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/user/support_pin"

응답 예시:

{
  "pin":"123456",
  "expires_at":"2025-02-27T22:06:57Z"
}

사용자의 지원 PIN 조회#

히스토리

• GitLab 17.8에서 도입되었습니다.

지정한 사용자의 지원 PIN에 대한 상세 정보를 조회합니다. GitLab 지원팀이 신원 확인을 위해 이 PIN을 요청할 수 있습니다.

사전 요구 사항:

• 관리자여야 합니다.

GET /users/:id/support_pin

요청 예시:

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/users/1234/support_pin"

응답 예시:

{
  "pin":"123456",
  "expires_at":"2025-02-27T22:06:57Z"
}

지원되는 속성:

사용자의 지원 PIN 취소#

히스토리

• GitLab 17.11에서 도입되었습니다.

자연 만료 이전에 지정한 사용자의 지원 PIN을 취소합니다. 이 작업은 PIN을 즉시 만료시키고 제거합니다.

사전 요구 사항:

• 관리자여야 합니다.

POST /users/:id/support_pin/revoke

요청 예시:

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/users/1234/support_pin/revoke"

응답 예시:

성공하면 202 Accepted를 반환합니다.

지원되는 속성: