gitlab api pro icon

gitlab api pro

Extended GitLab node

Branch → Get Many

AI-generated

Summary

Lists all branches within a specified GitLab project.

Inputs

  • Authentication — Select whether to use saved credentials or custom fields for this node (Optional, default: credential)
  • Server — Base URL of your GitLab instance, for example "https://gitlab.com" (Optional, default: https://gitlab.com)
  • AccessToken — Personal access token with API permissions (Optional)
  • Project Owner — Namespace or owner of the project. Used when "Project Locator" is set to "Path" (Optional)
  • Project Name — Project slug or name. Used when "Project Locator" is set to "Path" (Optional)
  • Project ID — Numeric project ID. Used when "Project Locator" is set to "ID" (Optional, default: 0)
  • Project Locator — Choose how to identify the project for project-scoped GitLab API endpoints (Optional, default: id)
  • Branch — Branch name, for example 'feature/login' (Optional)
  • Return All — Whether to return all results or only up to a given limit (Optional, default: false)
  • Limit — Max number of results to return (Optional, default: 50)

Output shape

a list of items, each containing branch metadata from the GitLab API response

When 'Return All' is enabled, the operation iterates through paginated results using per_page=100. When disabled, results are limited to the value of 'Limit' (default 50).

Examples

Example 1: List the first 10 branches in a project identified by ID 123

Project Locator set to 'ID', Limit set to 10

Example 2: Fetch all branches in a project identified by owner and path (e.g., 'mygroup/myproject')

Project Locator set to 'Path', Return All enabled

Links

Discussion