GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves members of a specific project from the GitLab API (version 4). It is useful for scenarios where you need to list or search project members, filter by user IDs, exclude certain users, or get additional seat and SAML identity information. For example, it can be used to manage project access or audit membership details in a GitLab project.

Use Case Examples

  1. Retrieve all members of a project by specifying the project ID.
  2. Search for members in a project using a query string.
  3. Filter members by specific user IDs or exclude certain users.
  4. Get seat information and list members with linked SAML identities.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request (boolean). Defaults to false.
baseUrl The base URL of the GitLab instance. Defaults to https://gitlab.com.
Method HTTP method to use for the request (GET, POST, PUT, DELETE, HEAD, PATCH). Defaults to GET.
Query Parameters Collection of optional query parameters to filter or paginate the members list.
Path Parameters Path parameters for the API request, including the project ID.

Output

JSON

  • id - The unique identifier of the member.
  • username - The username of the member.
  • name - The full name of the member.
  • state - The state of the member (e.g., active, blocked).
  • access_level - The access level of the member in the project.
  • expires_at - The expiration date of the member's access, if any.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the project ID is correctly provided in the path parameters; missing or incorrect ID will cause errors.
  • Verify that the authentication token is valid and has sufficient permissions to access project members.
  • Check the base URL if using a self-hosted GitLab instance to ensure it is correct.
  • Pagination parameters (page, per_page) should be set properly to avoid incomplete data retrieval.

Links

Discussion