GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation allows adding a member to a specific GitLab group by making a POST request to the GitLab API endpoint `/api/v4/groups/{id}/members`. It is useful for automating group membership management in GitLab, such as adding users to groups programmatically based on workflow triggers or external events.

Use Case Examples

  1. Automatically add a user to a GitLab group when they register in an external system.
  2. Manage group memberships dynamically in CI/CD pipelines by adding members to groups as needed.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for testing or when authentication is handled externally.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET but POST is used for this operation.
Path Parameters Parameters to be included in the request path, specifically the group ID (`id`) to which the member will be added.

Output

JSON

  • id - The ID of the added group member.
  • username - The username of the added member.
  • access_level - The access level granted to the member in the group.
  • created_at - Timestamp when the member was added to the group.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the group ID (`id`) path parameter is correctly provided and valid; otherwise, the API will return an error.
  • Authentication errors may occur if the GitLab API key is missing or invalid; verify credentials are correctly configured.
  • HTTP method must be set to POST for this operation; using other methods may cause unexpected behavior or errors.

Links

Discussion