Actions66
- Branch Actions
- File Actions
- Group Actions
- Issue Actions
- Merge Request Actions
- Pipeline Actions
- Project Actions
- Raw API Actions
- Release Actions
- Tag Actions
Overview
This node interacts with GitLab's API to manage groups, among other resources. Specifically for the Group - Get operation, it retrieves detailed information about a specific GitLab group by its numeric ID. This is useful when you want to fetch metadata or configuration details of a group within your GitLab instance.
Common scenarios include:
- Automating workflows that require group information, such as syncing group data with other systems.
- Fetching group details before performing further operations like managing group members or projects.
- Integrating GitLab group data into dashboards or reports.
Example: You have a GitLab group with ID 123 and want to retrieve its name, description, visibility, and other settings to display in an internal tool or use in conditional logic within an automation workflow.
Properties
| Name | Meaning |
|---|---|
| Authentication | Choose between using saved credentials ("Credential") or specifying custom connection details ("Custom"). |
| GitLab Server | Base URL of your GitLab instance (e.g., https://gitlab.com). Used only if "Custom" authentication is selected. |
| Access Token | Personal access token with API permissions for authentication. Used only if "Custom" authentication is selected. |
| Project Owner | Namespace or owner of the project; ignored if Project ID is set. Used only if "Custom" authentication is selected. |
| Project Name | Project slug or name; ignored if Project ID is set. Used only if "Custom" authentication is selected. |
| Project ID | Numeric project ID; takes precedence over owner and name if provided. Used only if "Custom" authentication is selected. |
| Resource | The resource type to work with; here it is fixed to "Group". |
| Operation | The action to perform on the resource; here it is "Get" to retrieve group details. |
| Group ID | Required. Numeric ID of the group to retrieve. Must be a positive integer. Default is 1. |
Output
The output is a JSON array where each item corresponds to the retrieved group data from GitLab. The structure matches the GitLab API response for a group, typically including fields such as:
id: Numeric group ID.name: Group name.path: URL path of the group.description: Description of the group.visibility: Visibility level (e.g., private, internal, public).- Other metadata like creation date, parent group info, membership settings, etc.
No binary data is output by this operation.
Dependencies
- Requires access to a GitLab instance, either the public
https://gitlab.comor a self-hosted GitLab server. - Requires an API access token with sufficient permissions to read group information.
- If using saved credentials, the node expects a configured credential with appropriate API access.
- No additional external dependencies beyond standard HTTP requests to GitLab API.
Troubleshooting
- Invalid Group ID: If the provided Group ID does not exist or is invalid (e.g., zero or negative), the node will throw an error. Ensure the Group ID is a positive integer corresponding to an existing group.
- Authentication Errors: If the access token is missing, expired, or lacks required permissions, the API call will fail with an authentication error. Verify the token and permissions.
- Network Issues: Connection problems to the GitLab server (wrong URL, network restrictions) will cause request failures. Confirm the server URL and network accessibility.
- API Rate Limits: Excessive requests may trigger rate limiting by GitLab. Implement retries or reduce request frequency if needed.