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 cataloga 1.006 acciones en 162 dominios, y 851 en la superficie Free/CE, mientras que este despliegue publica 747 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.

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), ref (string)

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)

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)

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)

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)

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)

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)

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)

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 matched pattern, default and protected flags, matching branch count, branch protection settings (allow force push, code-owner approval required), approval rules, 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)

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)

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)