Dominio de acciones

branch

Todas las acciones que este dominio expone vía gitlab_execute_action, del manifiesto gitlab://tools. Cada entrada se despliega a su descripción completa y sus parámetros obligatorios.

11 · acciones3 · destructivas5 · solo lectura

Contado con un token Free contra gitlab.com, que es el único host con el que habla este endpoint: para usarlo contra una instancia self-managed, levanta tú el servidor — su documentación lo cubre. El catálogo depende del token que pregunta, así que el recuento se mueve con su tier y con sus permisos: los tiers superiores exponen más acciones, y los dominios de administración solo aparecen a tokens autorizados a usarlos. Por eso las cifras difieren en otros sitios: el proyecto upstream cuenta 868 operaciones en Community Edition y hasta 1.094 en el tier más alto de GitLab.com, mientras que este despliegue publica 768 porque es solo-OAuth y actúa con tu token, así que los dominios de administración que una cuenta sin admin no puede llamar no aparecen nunca. Las tres describen el mismo catálogo, contado desde tres sitios distintos.

Cada entrada dice también qué necesita un token de acceso personal fine-grained de GitLab para ejecutarla, tal como lo declara GitLab 19.4.1: todos los permisos de una línea, en uno de los ámbitos indicados. Cuando hay alternativas, basta con cualquiera.

Volver a la ficha del servidor

1. branch.create

   Branch Create

   Create a branch from a source ref (branch, tag, or commit SHA). Returns: the created branch with its head commit object, protection and default flags, and web URL. See also: branch.list, merge_request.create, repository.compare.

   Parámetros obligatorios: branch_name (string), project_id (string|integer), ref (string)

   Token fine-grained: Branch: Create en proyecto

2. branch.delete

   Branch Deletedestructiva

   Delete a single branch by name. Returns: a success confirmation. Fails for protected or default branches. See also: branch.list, branch.unprotect.

   Parámetros obligatorios: branch_name (string), project_id (string|integer)

   Token fine-grained: Branch: Delete en proyecto

3. branch.delete_merged

   Branch Delete Mergeddestructiva

   Delete all branches merged into the default branch. Returns: a success confirmation. Protected and default branches are skipped. See also: branch.list, merge_request.list.

   Parámetros obligatorios: project_id (string|integer)

   Token fine-grained: Branch: Delete en proyecto

4. branch.get

   Branch Getsolo lectura

   Get a single branch by name. Returns: the branch with protection, default, and merged flags, push/merge permissions, the head commit object, and web URL. See also: branch.list, branch.protect, branch.unprotect.

   Parámetros obligatorios: branch_name (string), project_id (string|integer)

   Token fine-grained: Branch: Read en proyecto

5. branch.get_protected

   Protected Branch Getsolo lectura

   Get a single protected branch or wildcard rule by name. Returns: the rule with push, merge, and unprotect access-level arrays, allow-force-push, and CODEOWNERS-approval flags. See also: branch.list_protected, branch.update_protected, branch.unprotect.

   Parámetros obligatorios: branch_name (string), project_id (string|integer)

   Token fine-grained: Protected Branch: Read en proyecto

6. branch.list

   Branch Listsolo lectura

   List repository branches in one project with optional search/regex filtering, ordering, and offset or keyset pagination. Returns: matching branches with protection, default, merged flags, the head commit object, and pagination metadata. See also: branch.get, branch.create, repository.compare.

   Parámetros obligatorios: project_id (string|integer)

   Token fine-grained: Branch: Read en proyecto

7. branch.list_protected

   Protected Branches Listsolo lectura

   List protected branches and wildcard rules for a project with optional search, ordering, and offset or keyset pagination. Returns: protected rules with push/merge/unprotect access-level arrays and pagination metadata. See also: branch.get_protected, branch.protect, branch.update_protected.

   Parámetros obligatorios: project_id (string|integer)

   Token fine-grained: Protected Branch: Read en proyecto

8. branch.protect

   Branch Protect

   Protect a branch or wildcard with push/merge/unprotect access levels and optional fine-grained allowed_to_push/merge/unprotect entries. Returns: the protected rule with its access-level arrays. Idempotent: returns the existing rule when the branch is already protected. See also: branch.unprotect, branch.get_protected, branch.update_protected.

   Parámetros obligatorios: branch_name (string), project_id (string|integer)

   Token fine-grained: Branch: Protect en proyecto

9. branch.rule_list

   List Branch Rulessolo lectura

   List a project's aggregated branch protection rules by full project path. Returns: each branch rule with its id, matched pattern, default and protected flags, matching branch count, branch protection settings (who may push, merge and unprotect, allow force push, code-owner approval required, security-policy flags), approval rules with eligible approvers, external status checks, and keyset pagination metadata. Pages forward only: this GitLab connection takes first and after, and rejects last and before. See also: branch.list_protected, branch.get_protected, project.get.

   Parámetros obligatorios: project_path (string)

   Token fine-grained: ninguno puede ejecutarla en esta versión de GitLab, que no declara nada para ella; usa un token clásico

10. branch.unprotect

    Branch Unprotectdestructiva

    Remove protection from a branch (idempotent). Returns: a status and message confirming protection removed or already absent. See also: branch.protect, branch.get_protected, branch.delete.

    Parámetros obligatorios: branch_name (string), project_id (string|integer)

    Token fine-grained: Branch: Protect en proyecto

11. branch.update_protected

    Protected Branch Update

    Update an existing protected branch rule: allow-force-push, CODEOWNERS approval, rename, or fine-grained allowed_to_push/merge/unprotect entries. Returns: the updated rule with its access-level arrays. See also: branch.get_protected, branch.list_protected, branch.protect.

    Parámetros obligatorios: branch_name (string), project_id (string|integer)

    Token fine-grained: Protected Branch: Update en proyecto