gitlab api pro icon

gitlab api pro

Extended GitLab node

Branch → Get

AI-generated

Summary

Retrieves details for a specific GitLab branch within a configured project.

Inputs

  • authentication — Select whether to use saved credentials or custom fields (default: credential).
  • server — Base URL of your GitLab instance. Only shown when authentication is set to custom.
  • accessToken — Personal access token with API permissions. Only shown when authentication is set to custom.
  • projectLocator — Choose how to identify the project: 'ID' or 'Path'.
  • projectId — Numeric project ID. Used when projectLocator is set to 'ID'.
  • projectOwner — Namespace or owner of the project. Used when projectLocator is set to 'Path'.
  • projectName — Project slug or name. Used when projectLocator is set to 'Path'.
  • branch (required) — Branch name to retrieve details for.
  • ref (required) — Existing branch or commit to create the new branch from, e.g. 'main' (default: main).

Output shape

a list of items containing the full branch details from the GitLab API.

The node constructs a single item per input item index. The data shape mirrors the GitLab API v4 response for a single branch.

Examples

Example 1: Fetch details for a specific branch in a project identified by ID.

Project Locator: ID, Branch: 'feature/login'

Example 2: Fetch details for a branch in a project identified by path.

Project Locator: Path, Branch: 'production'

Links

Discussion