Dominio de acciones

repository

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.

41 · acciones2 · destructivas27 · 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. repository.archive

   Repository Archivesolo lectura

   Build the download URL for a repository archive. Returns: the project, ref/SHA, format, the subdirectory when one was asked for, and the archive download URL (binary content is not returned). See also: repository.tree, tag.list.

   Parámetros obligatorios: project_id (string|integer)

   Token fine-grained: no necesita ningún permiso

2. repository.blob

   Repository Blobsolo lectura

   Get a git blob by SHA. Returns: blob SHA, byte size, decoded text content (or image data), and a content category (text/image/binary). See also: repository.raw_blob, repository.tree.

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

   Token fine-grained: Repository: Read en proyecto

3. repository.changelog_add

   Repository Changelog Add

   Add changelog data to a changelog file by committing the generated entries. Returns: a success confirmation with the version. See also: repository.changelog_generate, release.create.

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

   Token fine-grained: Repository: Create en proyecto

4. repository.changelog_generate

   Repository Changelog Generatesolo lectura

   Generate changelog notes for a version range without committing. Returns: the rendered changelog notes (read-only preview). See also: repository.changelog_add, release.create.

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

   Token fine-grained: Repository: Read en proyecto

5. repository.commit_cherry_pick

   Commit Cherry Pick

   Cherry-pick a commit onto a target branch, optionally as a dry run. Returns: the newly created commit (SHA, title, author, dates, web URL) or a conflict error. See also: repository.commit_get, branch.list, repository.commit_revert.

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

   Token fine-grained: Commit: Create en proyecto

6. repository.commit_comment_create

   Commit Comment Create

   Post a comment on a commit, optionally inline on a specific file path and line. Returns: the created comment with note text, author user object, and optional path/line/line_type. See also: repository.commit_comments, repository.commit_diff, repository.commit_get.

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

   Token fine-grained: Commit: Update en proyecto

7. repository.commit_comments

   Commit Commentssolo lectura

   List the comments on a commit. Returns: comment entries with note text, author user object, optional file path, line, and line type, plus pagination metadata. See also: repository.commit_comment_create, repository.commit_get, repository.commit_diff.

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

   Token fine-grained: Commit: Read en proyecto

8. repository.commit_create

   Commit Create

   Create a commit with multiple file actions (create/update/delete/move/chmod) on a branch in one call. Returns: the created commit with SHA, title, author/committer, dates, parent IDs, stats, trailers, and web URL. See also: branch.list, repository.tree, repository.commit_get.

   Parámetros obligatorios: actions (array), branch (string), commit_message (string), project_id (string|integer)

   Token fine-grained: Commit: Create en proyecto

9. repository.commit_diff

   Commit Diffsolo lectura

   Get the file diffs of a single commit, optionally in unified-diff format. Returns: per-file diffs (old/new path, diff body, new/renamed/deleted flags, file modes) with pagination metadata. See also: repository.commit_get, repository.file_history, repository.commit_comments.

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

   Token fine-grained: Commit: Read en proyecto

10. repository.commit_discussion_add_note

    Add Commit Discussion Note

    Add a reply note to an existing commit discussion thread. Returns: the created note (author, body, timestamps, resolvable state). See also: repository.commit_discussion_create, repository.commit_discussion_get, repository.commit_discussion_update_note.

    Parámetros obligatorios: body (string), commit_sha (string), discussion_id (string), project_id (string|integer)

    Token fine-grained: Commit: Create en proyecto

11. repository.commit_discussion_create

    Create Commit Discussion

    Create a new discussion thread on a commit, optionally as an inline diff comment. Returns: the created thread with its first note (author, body, resolvable state, diff position). See also: repository.commit_discussion_add_note, repository.commit_discussion_list, repository.commit_diff.

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

    Token fine-grained: Commit: Create en proyecto

12. repository.commit_discussion_delete_note

    Delete Commit Discussion Notedestructiva

    Delete a note from a commit discussion thread (destructive). Returns: a deletion confirmation message. See also: repository.commit_discussion_update_note, repository.commit_discussion_get, repository.commit_discussion_list.

    Parámetros obligatorios: commit_sha (string), discussion_id (string), note_id (integer), project_id (string|integer)

    Token fine-grained: Commit: Delete en proyecto

13. repository.commit_discussion_get

    Get Commit Discussionsolo lectura

    Get a single commit discussion thread by its discussion id. Returns: the thread with every note (author, body, system flag, resolvable/resolved state, diff position). See also: repository.commit_discussion_list, repository.commit_discussion_add_note, repository.commit_get.

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

    Token fine-grained: Commit: Read en proyecto

14. repository.commit_discussion_list

    List Commit Discussionssolo lectura

    List discussion threads on a commit with ordering and keyset pagination. Returns: discussion threads with their notes (author, body, system flag, resolvable state, diff position) and pagination metadata. See also: repository.commit_discussion_get, repository.commit_discussion_create, repository.commit_get.

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

    Token fine-grained: Commit: Read en proyecto

15. repository.commit_discussion_update_note

    Update Commit Discussion Note

    Update the body of a note in a commit discussion thread. Returns: the updated note (author, body, timestamps). See also: repository.commit_discussion_add_note, repository.commit_discussion_delete_note, repository.commit_discussion_get.

    Parámetros obligatorios: body (string), commit_sha (string), discussion_id (string), note_id (integer), project_id (string|integer)

    Token fine-grained: Commit: Update en proyecto

16. repository.commit_get

    Commit Getsolo lectura

    Get a single commit from a project by SHA (full, short, branch, or tag). Returns: full commit metadata, message, parent IDs, author/committer, dates, stats, trailers, project ID, and last pipeline. See also: repository.file_history, repository.commit_diff, repository.commit_refs, repository.commit_statuses.

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

    Token fine-grained: Commit: Read en proyecto

17. repository.commit_list

    Commit Listsolo lectura

    List repository commits for a project, optionally filtered by ref_name, since/until, path, or author. Returns: commit summaries (SHA, title, author, dates, parent IDs, stats, trailers, last pipeline) with pagination metadata. See also: repository.commit_get, repository.commit_diff, repository.commit_statuses, branch.list.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Commit: Read en proyecto

18. repository.commit_merge_requests

    Commit Merge Requestssolo lectura

    List merge requests associated with a commit. Returns: compact MR rows with IID, project, title, state, draft flag, source/target branches, merge commit SHA, labels, author, web URL, and created, updated, merged and closed times, with pagination metadata. See also: repository.commit_get, merge_request.get, mr_review.changes_get.

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

    Token fine-grained: Commit: Read en proyecto

19. repository.commit_refs

    Commit Refssolo lectura

    List branches and tags that reference (contain) a commit, optionally filtered by ref type. Returns: ref entries with type and name plus pagination metadata. See also: repository.commit_get, branch.list, tag.list.

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

    Token fine-grained: Commit: Read en proyecto

20. repository.commit_revert

    Commit Revert

    Revert a commit on a target branch, creating a new commit that undoes it. Returns: the newly created revert commit (SHA, title, author, dates, web URL) or a conflict error. See also: repository.commit_get, branch.list, repository.commit_cherry_pick.

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

    Token fine-grained: Commit: Create en proyecto

21. repository.commit_signature

    Commit Signaturesolo lectura

    Get the signature (GPG/X.509/SSH) of a commit for authenticity verification. Returns: the signing key ID, primary key ID, signer name/email, verification status, and optional subkey ID. See also: repository.commit_get, repository.file_history.

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

    Token fine-grained: Commit: Read en proyecto

22. repository.commit_status_set

    Commit Status Set

    Set or update the pipeline status of a commit (used by external CI/reporting integrations). Returns: the resulting status with state, name, ref, coverage, pipeline ID, timestamps, and author user object. See also: repository.commit_statuses, repository.commit_get, pipeline.list.

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

    Token fine-grained: Commit Status: Create en proyecto

23. repository.commit_statuses

    Commit Statusessolo lectura

    List the statuses of a commit (CI jobs and external integrations), filtered by ref, stage, name, or pipeline. Returns: status entries with state, name, ref, coverage, pipeline ID, timestamps, and author user object, plus pagination metadata. See also: repository.commit_status_set, repository.commit_get, pipeline.list.

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

    Token fine-grained: Commit: Read en proyecto

24. repository.compare

    Repository Comparesolo lectura

    Compare two refs (branches, tags, or commits) in a project. Use from_project_id for cross-project comparison. Returns: commits, diffs, and comparison metadata. See also: repository.tree, branch.list.

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

    Token fine-grained: Repository: Read en proyecto

25. repository.contributors

    Repository Contributorssolo lectura

    List repository contributors. Returns: each contributor's name, email, commit count, additions, deletions, and pagination metadata. See also: repository.tree, repository.file_history.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Repository: Read en proyecto

26. repository.file_blame

    File Blamesolo lectura

    Get blame information for a file, optionally for a line range. Returns: file_path and blame ranges, each with commit id, message, author name/email, authored and committed dates, and the covered lines. See also: repository.file_get, repository.file_history.

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

    Token fine-grained: Repository: Read en proyecto

27. repository.file_create

    File Create

    Create a new file in a repository in a single commit. Returns: file_path, branch, commit_id, and last_commit_id. See also: repository.file_update, repository.file_get, repository.file_delete.

    Parámetros obligatorios: branch (string), commit_message (string), content (string), file_path (string), project_id (string|integer)

    Token fine-grained: Repository: Create en proyecto

28. repository.file_delete

    File Deletedestructiva

    Delete a file from a repository in a single commit. Returns: a success confirmation naming the file and project. See also: repository.file_get, repository.file_update.

    Parámetros obligatorios: branch (string), commit_message (string), file_path (string), project_id (string|integer)

    Token fine-grained: Repository: Delete en proyecto

29. repository.file_get

    File Getsolo lectura

    Get a single file's decoded content and metadata from a repository. Returns: file_name, file_path, size, encoding, content, content_sha256, ref, blob_id, commit_id, last_commit_id, and execute_filemode. See also: repository.file_raw, repository.file_metadata, repository.file_blame, repository.tree.

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

    Token fine-grained: Repository: Read en proyecto

30. repository.file_history

    Commit Listalias de repository.commit_listsolo lectura

    List repository commits for a project, optionally filtered by ref_name, since/until, path, or author. Returns: commit summaries (SHA, title, author, dates, parent IDs, stats, trailers, last pipeline) with pagination metadata. See also: repository.commit_get, repository.commit_diff, repository.commit_statuses, branch.list.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Commit: Read en proyecto

31. repository.file_metadata

    File Metadatasolo lectura

    Get a file's metadata without content (HEAD request). Returns: file_name, file_path, size, encoding, ref, blob_id, commit_id, last_commit_id, execute_filemode, and content_sha256. See also: repository.file_get, repository.file_raw_metadata.

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

    Token fine-grained: Repository: Read en proyecto

32. repository.file_raw

    File Rawsolo lectura

    Get the raw content of a file from a repository. Returns: file_path, size, content, and content_category. See also: repository.file_get, repository.file_raw_metadata.

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

    Token fine-grained: Repository: Read en proyecto

33. repository.file_raw_metadata

    File Raw Metadatasolo lectura

    Get raw file metadata without content (HEAD request to the raw endpoint). Returns: file_name, file_path, size, encoding, ref, blob_id, commit_id, last_commit_id, execute_filemode, and content_sha256. See also: repository.file_raw, repository.file_metadata.

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

    Token fine-grained: Repository: Read en proyecto

34. repository.file_update

    File Update

    Update an existing file in a repository in a single commit. Returns: file_path, branch, commit_id, and last_commit_id. See also: repository.file_create, repository.file_get, repository.file_delete.

    Parámetros obligatorios: branch (string), commit_message (string), content (string), file_path (string), project_id (string|integer)

    Token fine-grained: Repository: Update en proyecto

35. repository.list_submodules

    List Repository Submodulessolo lectura

    List the Git submodules defined in a repository's .gitmodules. Returns: each submodule's name, path, remote url, resolved_project, and pinned commit_sha, plus a count. See also: repository.read_submodule_file, repository.update_submodule, repository.tree.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Repository: Read en proyecto

36. repository.markdown_render

    Render Markdownsolo lectura

    Render arbitrary Markdown text to HTML using the GitLab Markdown API. Optionally apply GitLab Flavored Markdown and resolve references within a project's context. Returns: the rendered HTML string. See also: repository.file_get, wiki.get.

    Parámetros obligatorios: text (string)

    Token fine-grained: Markdown: Render en proyecto o usuario

37. repository.merge_base

    Repository Merge Basesolo lectura

    Find the common ancestor (merge base) of two or more refs. Returns: the merge-base commit with metadata and web URL. See also: repository.compare, branch.list.

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

    Token fine-grained: Repository: Read en proyecto

38. repository.raw_blob

    Repository Raw Blobsolo lectura

    Get the raw content of a git blob by SHA. Returns: blob SHA, byte size, decoded text content (or image data), and a content category (text/image/binary). See also: repository.blob, repository.tree.

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

    Token fine-grained: Repository: Read en proyecto

39. repository.read_submodule_file

    Read Repository Submodule Filesolo lectura

    Read a file from inside a submodule at the parent-pinned commit. Returns: file_name, file_path, submodule_path, resolved_project, commit_sha, size, decoded content, and encoding. See also: repository.list_submodules, repository.file_get, repository.update_submodule.

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

    Token fine-grained: Repository: Read en proyecto

40. repository.tree

    Repository Treesolo lectura

    List repository tree items. Returns: paths, object IDs, entry types (blob/tree/commit), modes, each entry's last commit when with_last_commit is set, and pagination metadata. See also: repository.blob, repository.raw_blob, branch.list.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Repository: Read en proyecto

41. repository.update_submodule

    Update Repository Submodule

    Update a submodule pointer to a new commit SHA on a branch. Returns: the created commit with id, short_id, title, author and committer details, dates, parent_ids, message, status, project_id, trailers, last_pipeline, and web_url. See also: repository.list_submodules, repository.read_submodule_file, repository.commit_get.

    Parámetros obligatorios: branch (string), commit_sha (string), project_id (string|integer), submodule (string)

    Token fine-grained: Repository Submodule: Update en proyecto