GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node interacts with the GitLab API to add a member to a specific group by making a POST request to the endpoint `/api/v4/groups/{id}/members`. It is useful for automating group membership management in GitLab, such as adding users to groups programmatically during onboarding or project setup.

Use Case Examples

  1. Automatically add a new user to a GitLab group when they join an organization.
  2. Integrate with a workflow that manages GitLab group memberships based on external system events.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the request.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the request is sent, defaulting to https://gitlab.com.
Method The HTTP method used for the request, defaulting to POST for this operation.
Path Parameters Parameters included in the request path, specifically the group ID to which a member is being added.

Output

JSON

  • id - The unique identifier of the added group member.
  • username - The username of the added member.
  • name - The full name of the added member.
  • state - The state of the member (e.g., active).
  • 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 provided in the path parameters is correct and the authenticated user has permission to add members to the group.
  • Verify that the API key credential is valid and has sufficient scopes to manage group members.
  • Common error messages include 401 Unauthorized (invalid or missing authentication), 404 Not Found (group ID does not exist), and 403 Forbidden (insufficient permissions). Resolving these involves checking credentials, permissions, and the correctness of the group ID.

Links

Discussion