Action domain

repository

Every action this domain exposes through gitlab_execute_action, from the gitlab://tools manifest. Each entry folds out to its full upstream description and required parameters.

41 · actions2 · destructive27 · read-only

Counted with a Free-tier token against gitlab.com, which is the only host this endpoint talks to: to use it against a self-managed instance, run the server yourself — its documentation covers that. The catalog is scoped to the token that asks, so the count moves with both its tier and its permissions: higher tiers expose more actions, and administration domains only appear to tokens allowed to use them. That is why the figures differ elsewhere: the upstream project catalogues 1,006 actions across 162 domains, and 851 on the Free/CE surface, while this deployment publishes 747 because it is OAuth-only and acts with your token, so the administration domains a non-admin account cannot call never appear. All three describe the same catalog, counted from three vantage points.

Back to the server card

1. repository.archive

   Repository Archiveread-only

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

   Required parameters: project_id (string)

2. repository.blob

   Repository Blobread-only

   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.

   Required parameters: project_id (string), sha (string)

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.

   Required parameters: project_id (string), version (string)

4. repository.changelog_generate

   Repository Changelog Generateread-only

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

   Required parameters: project_id (string), version (string)

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.

   Required parameters: branch (string), project_id (string)

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.

   Required parameters: note (string), project_id (string), sha (string)

7. repository.commit_comments

   Commit Commentsread-only

   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.

   Required parameters: project_id (string), sha (string)

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.

   Required parameters: actions (array), branch (string), commit_message (string), project_id (string)

9. repository.commit_diff

   Commit Diffread-only

   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.

   Required parameters: project_id (string), sha (string)

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.

    Required parameters: body (string), commit_sha (string), discussion_id (string), project_id (string)

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.

    Required parameters: body (string), commit_sha (string), project_id (string)

12. repository.commit_discussion_delete_note

    Delete Commit Discussion Notedestructive

    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.

    Required parameters: commit_sha (string), discussion_id (string), note_id (integer), project_id (string)

13. repository.commit_discussion_get

    Get Commit Discussionread-only

    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.

    Required parameters: commit_sha (string), discussion_id (string), project_id (string)

14. repository.commit_discussion_list

    List Commit Discussionsread-only

    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.

    Required parameters: commit_sha (string), project_id (string)

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.

    Required parameters: body (string), commit_sha (string), discussion_id (string), note_id (integer), project_id (string)

16. repository.commit_get

    Commit Getread-only

    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.

    Required parameters: project_id (string), sha (string)

17. repository.commit_list

    Commit Listread-only

    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.

    Required parameters: project_id (string)

18. repository.commit_merge_requests

    Commit Merge Requestsread-only

    List merge requests associated with a commit. Returns: basic MR entries with IID, title, state, source/target branches, web URL, and author. See also: repository.commit_get, merge_request.get, mr_review.changes_get.

    Required parameters: project_id (string), sha (string)

19. repository.commit_refs

    Commit Refsread-only

    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.

    Required parameters: project_id (string), sha (string)

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.

    Required parameters: branch (string), project_id (string)

21. repository.commit_signature

    Commit Signatureread-only

    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.

    Required parameters: project_id (string), sha (string)

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.

    Required parameters: project_id (string), sha (string), state (string)

23. repository.commit_statuses

    Commit Statusesread-only

    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.

    Required parameters: project_id (string), sha (string)

24. repository.compare

    Repository Compareread-only

    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.

    Required parameters: from (string), project_id (string), to (string)

25. repository.contributors

    Repository Contributorsread-only

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

    Required parameters: project_id (string)

26. repository.file_blame

    File Blameread-only

    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.

    Required parameters: file_path (string), project_id (string)

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.

    Required parameters: branch (string), commit_message (string), content (string), file_path (string), project_id (string)

28. repository.file_delete

    File Deletedestructive

    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.

    Required parameters: branch (string), commit_message (string), file_path (string), project_id (string)

29. repository.file_get

    File Getread-only

    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.

    Required parameters: file_path (string), project_id (string)

30. repository.file_history

    Commit Listalias of repository.commit_listread-only

    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.

    Required parameters: project_id (string)

31. repository.file_metadata

    File Metadataread-only

    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.

    Required parameters: file_path (string), project_id (string)

32. repository.file_raw

    File Rawread-only

    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.

    Required parameters: file_path (string), project_id (string)

33. repository.file_raw_metadata

    File Raw Metadataread-only

    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.

    Required parameters: file_path (string), project_id (string)

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.

    Required parameters: branch (string), commit_message (string), content (string), file_path (string), project_id (string)

35. repository.list_submodules

    List Repository Submodulesread-only

    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.

    Required parameters: project_id (string)

36. repository.markdown_render

    Render Markdownread-only

    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.

    Required parameters: text (string)

37. repository.merge_base

    Repository Merge Baseread-only

    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.

    Required parameters: project_id (string), refs (array)

38. repository.raw_blob

    Repository Raw Blobread-only

    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.

    Required parameters: project_id (string), sha (string)

39. repository.read_submodule_file

    Read Repository Submodule Fileread-only

    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.

    Required parameters: file_path (string), project_id (string), submodule_path (string)

40. repository.tree

    Repository Treeread-only

    List repository tree items. Returns: paths, object IDs, entry types (blob/tree), and pagination metadata. See also: repository.blob, repository.raw_blob, branch.list.

    Required parameters: project_id (string)

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, and web_url. See also: repository.list_submodules, repository.read_submodule_file, repository.commit_get.

    Required parameters: branch (string), commit_sha (string), project_id (string), submodule (string)