GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves the email addresses associated with a specific user in GitLab by making a GET request to the GitLab API endpoint `/api/v4/users/{id}/emails`. It is useful for scenarios where you need to fetch user email information for user management, auditing, or integration purposes within GitLab.

Use Case Examples

  1. Fetch emails of a user by their user ID to verify contact information.
  2. Retrieve paginated email addresses of a user for reporting or synchronization with other systems.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request.
Authentication The authentication method used for the API request, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the API request is sent.
Method The HTTP method used for the API request, defaulting to GET.
Query Parameters Optional query parameters for pagination, including page number and items per page.
Path Parameters Path parameters specifying the user ID whose emails are to be retrieved.

Output

JSON

  • emails - List of email addresses associated with the user
  • pagination
    • page - Current page number of the results
    • per_page - Number of items per page in the results
    • total - Total number of email items available

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the user ID provided in the path parameters is valid and exists in the GitLab instance to avoid 404 errors.
  • Verify that the API key credential has sufficient permissions to access user email information to prevent authorization errors.
  • Check the base URL is correctly set to the GitLab instance URL to avoid connection issues.

Links

Discussion