GitLab API

GitlabTool

Actions1095

Users → getApiV4UsersUserIdMemberships

AI-generated

Summary

Retrieve a list of memberships for a specific GitLab user by their user ID, optionally filtering by membership type and controlling pagination.

Inputs

  • user_id (required) — The ID of the user whose memberships to retrieve.
  • type — Filter memberships by type; allowed values are 'Project' or 'Namespace'.
  • page — Page number of the results to fetch, default is 1.
  • per_page — Number of memberships to return per page, default is 20.

Output shape

a list of membership records for the specified user

Results are paginated according to 'page' and 'per_page' parameters. Returns data from the GitLab API endpoint '/api/v4/users/{user_id}/memberships' via a GET request.

Examples

Example 1: Get first page of all memberships for user 123

Set path parameter user_id to 123; leave other query parameters empty or default.

Example 2: Get all project memberships for user 123, 50 per page

Set user_id to 123; set type query parameter to 'Project'; set per_page to 50.

Links

Discussion