Action domain
project
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.
123 · actions25 · destructive50 · 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.
Project Archiveproject.archiveArchive a project, making it read-only in GitLab. Returns: the project with archived set to true. See also:
project.unarchive,project.get.Required parameters:
project_id (string)
Add Project Badgeproject.badge_addAdd a badge to a project. Returns: the created badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also:
project.badge_list,project.badge_get.Required parameters:
image_url (string),link_url (string),project_id (string)
Delete Project Badgedestructiveproject.badge_deleteDelete a project badge by badge_id. Returns: a success confirmation. See also:
project.badge_list,project.badge_get.Required parameters:
badge_id (integer),project_id (string)
Edit Project Badgeproject.badge_editEdit a project badge's name, link_url, or image_url. Returns: the updated badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also:
project.badge_list,project.badge_get.Required parameters:
badge_id (integer),project_id (string)
Get Project Badgeread-onlyproject.badge_getGet a single project badge by badge_id. Returns: the badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also:
project.badge_list,project.badge_edit.Required parameters:
badge_id (integer),project_id (string)
List Project Badgesread-onlyproject.badge_listList badges for a project, including inherited group badges. Returns: badges (id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind) plus pagination metadata. See also:
project.badge_get,project.badge_add.Required parameters:
project_id (string)
Preview Project Badgeread-onlyproject.badge_previewPreview how a project badge's link_url and image_url resolve after placeholder interpolation, without persisting it. Returns: the rendered badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also:
project.badge_add,project.badge_list.Required parameters:
image_url (string),link_url (string),project_id (string)
Board Createproject.board_createCreate a new issue board in a project. Returns: the created board with its project, scope, and lists. See also:
project.board_get,project.board_update,project.board_list.Required parameters:
name (string),project_id (string)
Board Deletedestructiveproject.board_deleteDelete an issue board permanently. Returns: a success confirmation naming the board and project. See also:
project.board_get,project.board_list.Required parameters:
board_id (integer),project_id (string)
Board Getread-onlyproject.board_getGet a single issue board by board_id. Returns: the board with its project, milestone, assignee, scope labels, and ordered lists. See also:
project.board_list,project.board_update,project.board_delete.Required parameters:
board_id (integer),project_id (string)
Board Listread-onlyproject.board_listList a project's issue boards with pagination. Returns: each board with its project, milestone, assignee, scope labels, and lists. See also:
project.board_get,project.board_create,project.board_list_list.Required parameters:
project_id (string)
Board List Createproject.board_list_createCreate a board list (column) scoped to a label, assignee, milestone, or iteration. Returns: the created list with its scope, position, and issue limits. See also:
project.board_list_get,project.board_list_update,project.board_list_list.Required parameters:
board_id (integer),project_id (string)
Board List Deletedestructiveproject.board_list_deleteDelete a board list (column) permanently. Returns: a success confirmation naming the list. See also:
project.board_list_get,project.board_list_list.Required parameters:
board_id (integer),list_id (integer),project_id (string)
Board List Getread-onlyproject.board_list_getGet a single board list by list_id. Returns: the list with its label, assignee, milestone, iteration, position, and issue limits. See also:
project.board_list_list,project.board_list_update,project.board_list_delete.Required parameters:
board_id (integer),list_id (integer),project_id (string)
Board List Listsread-onlyproject.board_list_listList the lists (columns) in an issue board with pagination. Returns: each list with its label, assignee, milestone, iteration, position, and issue limits. See also:
project.board_list_get,project.board_list_create,project.board_get.Required parameters:
board_id (integer),project_id (string)
Board List Updateproject.board_list_updateReorder a board list to a new position. Returns: the updated list with its scope, position, and issue limits. See also:
project.board_list_get,project.board_list_list,project.board_list_delete.Required parameters:
board_id (integer),list_id (integer),position (integer),project_id (string)
Board Updateproject.board_updateUpdate an issue board's name, scope (assignee, milestone, labels, weight), or list visibility. Returns: the updated board with its project, scope, and lists. See also:
project.board_get,project.board_delete,project.board_list.Required parameters:
board_id (integer),project_id (string)
Project Createproject.createCreate a new GitLab project. Returns: the created project with id, path_with_namespace, default_branch, visibility, and web URL. See also:
project.get,project.update,project.create_for_user.Required parameters:
name (string)
Project Create For Userproject.create_for_userCreate a project on behalf of a user (admin). Returns: the created project with id, owner namespace, visibility, and web URL. See also:
project.create,project.get.Required parameters:
name (string),user_id (integer)
Project Create Fork Relationproject.create_fork_relationCreate a fork relationship to an upstream project. Returns: the downstream project as GitLab answers with it, including forked_from_project. See also:
project.delete_fork_relation,project.fork.Required parameters:
forked_from_id (integer),project_id (string)
Project Deletedestructiveproject.deleteDelete a project. Returns: a deletion status. On instances with delayed deletion the project is marked for deletion. See also:
project.restore,project.archive.Required parameters:
project_id (string)
Project Delete Fork Relationdestructiveproject.delete_fork_relationRemove a project's fork relationship. Returns: a success confirmation naming the project. See also:
project.create_fork_relation,project.fork.Required parameters:
project_id (string)
Project Download Avatarread-onlyproject.download_avatarDownload a project's avatar. Returns: the avatar image content. See also:
project.upload_avatar,project.get.Required parameters:
project_id (string)
Download Project Exportread-onlyproject.export_downloadDownload a finished project export archive as base64. Returns: base64 archive content and size in bytes. See also:
project.export_status,project.import_from_file.Required parameters:
project_id (string)
Schedule Project Exportproject.export_scheduleSchedule an asynchronous project export. Returns: a confirmation message. See also:
project.export_status,project.export_download.Required parameters:
project_id (string)
Get Project Export Statusread-onlyproject.export_statusGet the export status of a project. Returns: export id, name, path, status, message, and download links. See also:
project.export_schedule,project.export_download.Required parameters:
project_id (string)
Project Forkproject.forkFork a project. Returns: the new fork with id, path_with_namespace, forked_from_project, and web URL. See also:
project.list_forks,project.create_fork_relation.Required parameters:
project_id (string)
Project Getread-onlyproject.getGet a single project by ID or namespace path. Returns: project metadata including id, path_with_namespace, default_branch, visibility, and web URL. See also:
project.update,project.archive,project.delete.Required parameters:
project_id (string)
Project Hook Addproject.hook_addAdd a webhook to a project. Returns: the created webhook with id, URL, and enabled events. See also:
project.hook_list,project.hook_test.Required parameters:
project_id (string),url (string)
Project Hook Deletedestructiveproject.hook_deleteDelete a project webhook. Returns: a success confirmation naming the webhook and project. See also:
project.hook_list,project.hook_add.Required parameters:
hook_id (integer),project_id (string)
Project Hook Delete Custom Headerdestructiveproject.hook_delete_custom_headerDelete a custom header from a project webhook. Returns: a success confirmation naming the header and webhook. See also:
project.hook_set_custom_header,project.hook_get.Required parameters:
hook_id (integer),key (string),project_id (string)
Project Hook Delete URL Variabledestructiveproject.hook_delete_url_variableDelete a URL variable from a project webhook. Returns: a success confirmation naming the variable and webhook. See also:
project.hook_set_url_variable,project.hook_get.Required parameters:
hook_id (integer),key (string),project_id (string)
Project Hook Editproject.hook_editEdit a project webhook. Returns: the updated webhook with URL and enabled events. See also:
project.hook_get,project.hook_test.Required parameters:
hook_id (integer),project_id (string)
Project Hook Getread-onlyproject.hook_getGet a single project webhook. Returns: the webhook with URL, enabled events, and SSL settings. See also:
project.hook_list,project.hook_edit.Required parameters:
hook_id (integer),project_id (string)
Project Hook Listread-onlyproject.hook_listList a project's webhooks. Returns: webhooks with URL, enabled events, and SSL settings, plus pagination metadata. See also:
project.hook_get,project.hook_add.Required parameters:
project_id (string)
Project Hook Set Custom Headerproject.hook_set_custom_headerSet a custom header on a project webhook. Returns: a success confirmation naming the header and webhook. See also:
project.hook_delete_custom_header,project.hook_get.Required parameters:
hook_id (integer),key (string),project_id (string),value (string)
Project Hook Set URL Variableproject.hook_set_url_variableSet a URL variable on a project webhook. Returns: a success confirmation naming the variable and webhook. See also:
project.hook_delete_url_variable,project.hook_get.Required parameters:
hook_id (integer),key (string),project_id (string),value (string)
Project Hook Testproject.hook_testTrigger a test event for a project webhook. Returns: a confirmation that the test event was fired. See also:
project.hook_get,project.hook_edit.Required parameters:
event (string),hook_id (integer),project_id (string)
Import Project From Fileproject.import_from_fileImport a project from an export archive. Returns: the new project's import status, type, correlation id, and any import error. See also:
project.import_status,project.export_download.Required parameters: No required parameters
Get Project Import Statusread-onlyproject.import_statusGet the import status of a project. Returns: import id, name, path, status, type, correlation id, and import error. See also:
project.import_from_file.Required parameters:
project_id (string)
Delete Integrationdestructiveproject.integration_deleteDelete (disable) a project integration by slug. Supports the same slugs as get, plus 'slack-application' for disabling the GitLab for Slack app.
Returns: confirmation message.
See also:
project.integration_list,project.integration_get.Required parameters:
project_id (string),slug (string)
Delete Group Integrationdestructiveproject.integration_delete_groupDelete (disable) a group integration by slug. Requires Owner role on the group.
Returns: confirmation message.
See also:
project.integration_list_group,project.integration_get_group,project.integration_set_group.Required parameters:
group_id (string),slug (string)
Delete Group Datadog Integrationdestructiveproject.integration_delete_group_datadogRemove the Datadog integration from a group. The stored api_key is cleared. Deletion is irreversible. Requires Owner role and GitLab Premium/Ultimate (self-managed EE or GitLab.com).
Returns: confirmation message.
See also:
project.integration_get_group_datadog,project.integration_set_group_datadog.Required parameters:
group_id (string)
Get Integrationread-onlyproject.integration_getGet details of a specific project integration by slug (e.g. jira, slack, discord, mattermost, microsoft-teams, telegram, datadog, jenkins, emails-on-push, pipelines-email, external-wiki, custom-issue-tracker, drone-ci, github, harbor, matrix, redmine, youtrack, slack-slash-commands, mattermost-slash-commands).
Returns: JSON with integration details.
See also:
project.integration_list,project.integration_delete.Required parameters:
project_id (string),slug (string)
Get Group Integrationread-onlyproject.integration_get_groupGet details of a specific group integration by slug. Requires Owner role on the group.
Returns: JSON with the group integration details.
See also:
project.integration_list_group,project.integration_set_group,project.integration_delete_group.Required parameters:
group_id (string),slug (string)
Get Group Datadog Integrationread-onlyproject.integration_get_group_datadogRead the Datadog integration configured on a group. Requires Owner role and GitLab Premium/Ultimate (self-managed EE or GitLab.com). The api_key is never returned.
Returns: JSON with the group's Datadog integration details. The canonical configuration is the nested properties object (api_url, datadog_env, datadog_service, datadog_site, datadog_tags, datadog_ci_visibility, archive_trace_events). The flat top-level copies of those fields are deprecated and will be removed. Prefer properties.*.
See also:
project.integration_set_group_datadog,project.integration_delete_group_datadog.Required parameters:
group_id (string)
List Integrationsread-onlyproject.integration_listList all integrations (services) configured for a project, including their active status.
Returns: JSON array of integration items with id, title, slug, and active flag.
See also:
project.integration_get,project.integration_set_jira,project.integration_delete.Required parameters:
project_id (string)
List Group Integrationsread-onlyproject.integration_list_groupList all active integrations configured on a group. Requires Owner role (some integrations require GitLab Premium/Ultimate).
Returns: JSON array of group integration items with id, title, slug, and active flag.
See also:
project.integration_get_group,project.integration_set_group,project.integration_delete_group.Required parameters:
group_id (string)
Set Integrationproject.integration_setConfigure (create or update) any project integration by slug, passing the integration's documented parameters in a free-form `config` object. Use this generic action for integrations without a dedicated tool (e.g. slack, harbor, jenkins, google-play, apple-app-store, prometheus, microsoft-teams, mattermost, discord).
Common slugs: slack, jira, discord, mattermost, microsoft-teams, telegram, datadog, jenkins, harbor, drone-ci, github, emails-on-push, pipelines-email, external-wiki, custom-issue-tracker, matrix, redmine, youtrack, slack-slash-commands, mattermost-slash-commands, google-play, apple-app-store, prometheus, bamboo, buildkite, campfire, confluence, packagist, pivotaltracker, pumble, pushover, teamcity, unify-circuit, webex-teams, zentao, gitlab-slack-application.
The `config` object is sent verbatim as the request body. See doc/api/integrations.md for the exact fields each integration accepts (for example slack expects `webhook`. Harbor expects `url`, `project_name`, `username`, `password`).
Returns: JSON with the resulting integration details.
See also:
project.integration_get,project.integration_list,project.integration_delete,project.integration_set_jira.Required parameters:
project_id (string),slug (string)
Set Group Integrationproject.integration_set_groupConfigure (create or update) any group integration by slug, passing the integration's documented parameters in a free-form `config` object. Requires Owner role on the group (some integrations require GitLab Premium/Ultimate).
The `config` object is sent verbatim as the request body. See doc/api/group_integrations.md and doc/api/integrations.md for the per-integration fields.
Returns: JSON with the resulting group integration details.
See also:
project.integration_get_group,project.integration_list_group,project.integration_delete_group.Required parameters:
group_id (string),slug (string)
Set Group Datadog Integrationproject.integration_set_group_datadogCreate or update the Datadog integration on a group. Requires Owner role and GitLab Premium/Ultimate (self-managed EE or GitLab.com). At least one of api_key, api_url, datadog_env, datadog_service, datadog_site, datadog_tags, datadog_ci_visibility, archive_trace_events, or use_inherited_settings=true must be supplied.
Returns: JSON with the updated Datadog integration details (canonical values in the nested properties object. Flat copies are deprecated, so prefer properties.*).
See also:
project.integration_get_group_datadog,project.integration_delete_group_datadog.Required parameters:
group_id (string)
Set Jira Integrationproject.integration_set_jiraConfigure the Jira integration for a project. Sets up the connection to a Jira instance with URL, credentials, and event triggers.
Returns: JSON with the configured Jira integration details.
See also:
project.integration_list,project.integration_get.Required parameters:
project_id (string),url (string)
Label Createproject.label_createCreate a project label with required name and hex color, plus optional description, priority, and archived state. Returns: the created label (id, name, color, text_color, description, counts, priority, subscribed, is_project_label, archived). See also:
project.label_get,project.label_update,issue.list.Required parameters:
color (string),name (string),project_id (string)
Label Deletedestructiveproject.label_deleteDelete a project label by ID or name. Destructive: the label is removed from the project and unassigned from issues and merge requests. Returns: a deletion confirmation. See also:
project.label_list,project.label_get,project.label_create.Required parameters:
label_id (string),project_id (string)
Label Getread-onlyproject.label_getGet a single project label by ID or name. Returns: id, name, color, text_color, description, open/closed issue counts, open MR count, priority, subscribed, is_project_label, and archived. See also:
project.label_list,project.label_update,project.label_delete.Required parameters:
label_id (string),project_id (string)
Label Listread-onlyproject.label_listList labels in a project with optional search, counts, ancestor-group inclusion, ordering, and offset or keyset pagination. Returns: id, name, color, text_color, description, open/closed issue counts, open MR count, priority, subscribed, is_project_label, archived, and pagination metadata. See also:
project.label_get,project.label_create,issue.list.Required parameters:
project_id (string)
Label Promoteproject.label_promotePromote a project label to a group label, sharing it across the group's projects. Returns: no content on success. Requires group-level Maintainer or higher access. See also:
project.label_get,project.label_list,group.group_label_list.Required parameters:
label_id (string),project_id (string)
Label Subscribeproject.label_subscribeSubscribe the authenticated user to a project label for notifications. Returns: the label with subscribed=true (already-subscribed yields 304 Not Modified). See also:
project.label_unsubscribe,project.label_get,project.label_list.Required parameters:
label_id (string),project_id (string)
Label Unsubscribeproject.label_unsubscribeUnsubscribe the authenticated user from a project label. Returns: no content on success (not-subscribed yields 304 Not Modified). See also:
project.label_subscribe,project.label_get,project.label_list.Required parameters:
label_id (string),project_id (string)
Label Updateproject.label_updateUpdate an existing project label (new_name, color, description, priority, archived). Returns: the updated label (id, name, color, text_color, description, counts, priority, subscribed, is_project_label, archived). See also:
project.label_get,project.label_list,project.label_delete.Required parameters:
label_id (string),project_id (string)
Project Languagesread-onlyproject.languagesGet a project's detected languages. Returns: language names with their percentage of the codebase. See also:
project.get.Required parameters:
project_id (string)
Project Listread-onlyproject.listList projects accessible to the user with filtering and pagination. Returns: projects with namespace, visibility, last_activity_at, and pagination metadata. See also:
project.get,project.list_user_projects.Required parameters: No required parameters
Project List Forksread-onlyproject.list_forksList a project's forks. Returns: forked projects with namespace, visibility, and pagination metadata. See also:
project.fork,project.get.Required parameters:
project_id (string)
Project List Groupsread-onlyproject.list_groupsList a project's associated groups. Returns: groups with id, full_path, and full_name, plus pagination metadata. See also:
project.list_invited_groups,group.get.Required parameters:
project_id (string)
Project List Invited Groupsread-onlyproject.list_invited_groupsList groups invited to a project. Returns: invited groups with id, full_path, and full_name, plus pagination metadata. See also:
project.share_with_group,project.list_groups.Required parameters:
project_id (string)
Project List Starrersread-onlyproject.list_starrersList a project's starrers. Returns: users with their starred_since date, plus pagination metadata. See also:
project.star,project.list_user_starred.Required parameters:
project_id (string)
Project List User Contributedread-onlyproject.list_user_contributedList projects a user contributed to. Returns: projects with namespace, visibility, and pagination metadata. See also:
project.list_user_projects,project.list_user_starred.Required parameters:
user_id (string)
Project List User Projectsread-onlyproject.list_user_projectsList a user's owned projects. Returns: projects with namespace, visibility, and pagination metadata. See also:
project.list_user_contributed,project.list_user_starred.Required parameters:
user_id (string)
Project List User Starredread-onlyproject.list_user_starredList projects a user starred. Returns: projects with namespace, visibility, and pagination metadata. See also:
project.list_user_projects,project.list_starrers.Required parameters:
user_id (string)
Project List Usersread-onlyproject.list_usersList a project's users. Returns: users with id, username, name, and state, plus pagination metadata. See also:
project.get,project.members.Required parameters:
project_id (string)
Project Member Addproject.member_addAdd a user to a project team by user_id or username with an access level. Optional: expires_at, member_role_id (Premium/Ultimate). Returns: the created membership. See also:
project.member_edit,project.members,user.list.Required parameters:
project_id (string),user_id (integer)
Project Member Deletedestructiveproject.member_deleteRemove a member from a project (destructive, requires confirmation). Requires Maintainer. The last Owner of a project cannot be removed. Returns: a success confirmation naming the removed member. See also:
project.member_edit,project.members.Required parameters:
project_id (string),user_id (integer)
Project Member Editproject.member_editEdit a project member's access level, expiry, or custom member role. Returns: the updated membership. Requires at least the same access level as the target member. See also:
project.member_add,project.member_delete,project.members.Required parameters:
project_id (string),user_id (integer)
Project Member Getread-onlyproject.member_getGet a single direct project member by user ID. Returns: id, username, name, state, access level, member role, created_by, expiry, and web URL. Does not include inherited members. See also:
project.member_inherited,project.members,project.member_edit.Required parameters:
project_id (string),user_id (integer)
Project Member Get Inheritedread-onlyproject.member_inheritedGet a project member including membership inherited from parent groups. Returns: id, username, name, state, effective access level, member role, and web URL. See also:
project.member_get,project.members.Required parameters:
project_id (string),user_id (integer)
Project Members Listread-onlyproject.membersList a project's members (direct plus inherited from parent groups). Returns: each member's id, username, name, state, access level, member role, created_by, seat usage, and web URL. Supports query/user_ids/show_seat_info filtering, order_by/sort, and offset or keyset pagination. See also:
project.member_get,project.member_add,project.get.Required parameters:
project_id (string)
Milestone Createproject.milestone_createCreate a new milestone in a project with title and optional description, start date, and due date. Returns: the created milestone with IID, state, dates, and web URL. See also:
project.milestone_get,project.milestone_update,project.milestone_list.Required parameters:
project_id (string),title (string)
Milestone Deletedestructiveproject.milestone_deleteDelete a milestone permanently from a project by milestone IID. Returns: a success confirmation naming the milestone and project. See also:
project.milestone_get,project.milestone_update,project.milestone_list.Required parameters:
milestone_iid (integer),project_id (string)
Milestone Getread-onlyproject.milestone_getGet a single milestone from a project by milestone IID. Returns: milestone title, description, state, start/due dates, expiry, group/project IDs, timestamps, and web URL. See also:
project.milestone_list,project.milestone_update,project.milestone_issues,project.milestone_merge_requests.Required parameters:
milestone_iid (integer),project_id (string)
Milestone Issuesread-onlyproject.milestone_issuesList issues assigned to a single milestone with ordering and pagination. Returns: assigned issues with IID, title, state, web URL, creation time, and pagination metadata. See also:
project.milestone_get,project.milestone_merge_requests,issue.list.Required parameters:
milestone_iid (integer),project_id (string)
Milestone Listread-onlyproject.milestone_listList milestones in one project with state/title/search filters, ancestor inclusion, ordering, and pagination. Returns: matching milestones with state, dates, expiry, web URL, and pagination metadata. See also:
project.milestone_get,project.milestone_create,project.milestone_issues.Required parameters:
project_id (string)
Milestone Merge Requestsread-onlyproject.milestone_merge_requestsList merge requests assigned to a single milestone with ordering and pagination. Returns: assigned merge requests with IID, title, state, source/target branches, web URL, creation time, and pagination metadata. See also:
project.milestone_get,project.milestone_issues,merge_request.list.Required parameters:
milestone_iid (integer),project_id (string)
Milestone Updateproject.milestone_updateUpdate an existing milestone's title, description, start/due dates, or state (state_event close/activate) by milestone IID. Returns: the updated milestone with state, dates, and web URL. See also:
project.milestone_get,project.milestone_delete,project.milestone_list.Required parameters:
milestone_iid (integer),project_id (string)
Add Project Mirrordestructiveproject.mirror_addCreate a push (remote) mirror on a project. Destructive: the host in url receives the whole repository from then on, so confirmation is required. Returns: the created mirror with id, enabled state, redacted URL, and update status. See also:
project.mirror_list,project.mirror_edit,project.mirror_get_public_key.Required parameters:
project_id (string),url (string)
Delete Project Mirrordestructiveproject.mirror_deleteDelete a push mirror from a project permanently. Returns: a success confirmation naming the mirror and project. See also:
project.mirror_get,project.mirror_edit.Required parameters:
mirror_id (integer),project_id (string)
Edit Project Mirrorproject.mirror_editUpdate a push mirror's attributes (enabled, branch filtering, divergent refs, auth method). Returns: the updated mirror. See also:
project.mirror_get,project.mirror_force_push.Required parameters:
mirror_id (integer),project_id (string)
Force Push Mirror Updatedestructiveproject.mirror_force_pushTrigger an immediate update of a push mirror. Returns: a confirmation that the update was triggered. See also:
project.mirror_get,project.mirror_edit.Required parameters:
mirror_id (integer),project_id (string)
Get Project Mirrorread-onlyproject.mirror_getGet a single push mirror of a project by mirror id. Returns: the mirror with enabled state, redacted URL, auth method, branch filtering, and last-update status/error. See also:
project.mirror_list,project.mirror_edit,project.mirror_force_push.Required parameters:
mirror_id (integer),project_id (string)
Get Project Mirror Public Keyread-onlyproject.mirror_get_public_keyGet the SSH public key for an SSH-authenticated push mirror. Returns: the public key to register on the remote. See also:
project.mirror_get,project.mirror_edit.Required parameters:
mirror_id (integer),project_id (string)
List Project Mirrorsread-onlyproject.mirror_listList a project's push (remote) mirrors. Returns: each mirror with id, enabled state, redacted URL, last-update status, and pagination metadata. See also:
project.mirror_get,project.mirror_add.Required parameters:
project_id (string)
Pages Domain Createproject.pages_domain_createAdd a new custom Pages domain to a project. Returns: the created domain with verification code, auto-SSL flag, and certificate details. See also:
project.pages_domain_get,project.pages_domain_update,project.pages_domain_list.Required parameters:
domain (string),project_id (string)
Pages Domain Deletedestructiveproject.pages_domain_deleteRemove a custom Pages domain from a project (destructive). Returns: a success confirmation naming the deleted domain. See also:
project.pages_domain_get,project.pages_domain_list.Required parameters:
domain (string),project_id (string)
Pages Domain Getread-onlyproject.pages_domain_getGet a single Pages custom domain by name. Returns: the domain with verification status and code, auto-SSL flag, enabled-until date, and certificate subject/expiration. See also:
project.pages_domain_list,project.pages_domain_update,project.pages_domain_delete.Required parameters:
domain (string),project_id (string)
Pages Domain Listread-onlyproject.pages_domain_listList the custom Pages domains for a project with pagination. Returns: matching domains with verification status, auto-SSL flag, project ID, certificate details, and pagination metadata. See also:
project.pages_domain_get,project.pages_domain_create,project.pages_domain_list_all.Required parameters:
project_id (string)
Pages Domain List Allread-onlyproject.pages_domain_list_allList ALL GitLab Pages custom domains across the whole instance in one call (admin only). Use this instead of gitlab_pages_domain_list when you need every domain on the instance, not just those attached to a single project. Returns: all domains with verification status, auto-SSL flag, project ID, and certificate subject. See also:
project.pages_domain_list,project.pages_domain_get,project.pages_domain_create.Required parameters: No required parameters
Pages Domain Updateproject.pages_domain_updateUpdate an existing Pages custom domain's auto-SSL flag or certificate. Returns: the updated domain with verification status and certificate details. See also:
project.pages_domain_get,project.pages_domain_delete,project.pages_domain_list.Required parameters:
domain (string),project_id (string)
Pages Getread-onlyproject.pages_getGet the Pages settings for a project. Returns: the Pages URL, force-HTTPS and unique-domain flags, primary domain, and recent deployments. See also:
project.pages_update,project.pages_unpublish,project.pages_domain_list.Required parameters:
project_id (string)
Pages Unpublishdestructiveproject.pages_unpublishUnpublish a project's Pages site (destructive). Returns: a success confirmation. See also:
project.pages_get,project.pages_update.Required parameters:
project_id (string)
Pages Updateproject.pages_updateUpdate the Pages settings for a project. Returns: the updated Pages settings with URL, force-HTTPS and unique-domain flags, primary domain, and deployments. See also:
project.pages_get,project.pages_domain_create,project.pages_unpublish.Required parameters:
project_id (string)
Project Repository Storage Getread-onlyproject.repository_storage_getGet a project's repository storage shard. Returns: the storage shard name. See also:
project.start_housekeeping,project.get.Required parameters:
project_id (string)
Project Restoreproject.restoreRestore a project marked for deletion. Returns: the restored project. See also:
project.delete,project.get.Required parameters:
project_id (string)
Project Service Account Createproject.service_account_createCreate a GitLab project service account. Returns: the created project service account object. See also:
project.service_account_list,project.service_account_update,project.service_account_pat_create.Required parameters:
project_id (string)
Project Service Account Deletedestructiveproject.service_account_deleteDelete a GitLab project service account. Returns: a success status confirming deletion. See also:
project.service_account_list,project.service_account_update.Required parameters:
project_id (string),service_account_id (integer)
Project Service Account Listread-onlyproject.service_account_listList GitLab project service accounts. Returns: paginated project service account records. See also:
project.get,project.service_account_create,project.service_account_pat_list.Required parameters:
project_id (string)
Project Service Account Pat Createproject.service_account_pat_createCreate a personal access token for a GitLab project service account. Returns: the created token record and token value when GitLab returns it. See also:
project.service_account_pat_list,project.service_account_pat_rotate.Required parameters:
name (string),project_id (string),scopes (array),service_account_id (integer)
Project Service Account Pat Listread-onlyproject.service_account_pat_listList personal access tokens for a GitLab project service account. Returns: paginated token records. See also:
project.service_account_list,project.service_account_pat_create,project.service_account_pat_revoke.Required parameters:
project_id (string),service_account_id (integer)
Project Service Account Pat Revokedestructiveproject.service_account_pat_revokeRevoke a personal access token for a GitLab project service account. Returns: a success status confirming revocation. See also:
project.service_account_pat_list,project.service_account_pat_create.Required parameters:
project_id (string),service_account_id (integer),token_id (integer)
Project Service Account Pat Rotateproject.service_account_pat_rotateRotate a personal access token for a GitLab project service account. Returns: the rotated token record and token value when GitLab returns it. See also:
project.service_account_pat_list,project.service_account_pat_revoke.Required parameters:
project_id (string),service_account_id (integer),token_id (integer)
Project Service Account Updateproject.service_account_updateUpdate a GitLab project service account. Returns: the updated project service account object. See also:
project.service_account_list,project.service_account_delete.Required parameters:
project_id (string),service_account_id (integer)
Project Starproject.starStar a project. Returns: the project with the updated star_count. See also:
project.unstar,project.list_starrers.Required parameters:
project_id (string)
Project Start Housekeepingproject.start_housekeepingStart housekeeping for a project. Returns: a success confirmation naming the project. See also:
project.repository_storage_get,project.get.Required parameters:
project_id (string)
Get Project Statisticsread-onlyproject.statistics_getGet a project's last-30-days git fetch (clone/pull) statistics. Returns: total_fetches and a per-day breakdown of date and count. See also:
project.get.Required parameters:
project_id (string)
Project Transferdestructiveproject.transferTransfer a project to another namespace. Returns: the project in its new namespace. See also:
project.get,group.get.Required parameters:
namespace (string),project_id (string)
Project Unarchiveproject.unarchiveUnarchive a project. Returns: the project with archived set to false. See also:
project.archive,project.get.Required parameters:
project_id (string)
Project Unstarproject.unstarUnstar a project. Returns: the project with the updated star_count. See also:
project.star,project.list_starrers.Required parameters:
project_id (string)
Project Updateproject.updateUpdate a project's settings. Returns: the updated project with its current configuration and web URL. See also:
project.get,project.archive,project.transfer.Required parameters:
project_id (string)
Project Uploadproject.uploadUpload a file (via local file_path or base64 content) to a project's Markdown attachments store. Returns: the upload's id (GitLab 17.3+), alt text, relative and full URLs, full path, and a Markdown embed reference. See also:
project.upload_list,project.upload_delete,project.get.Required parameters:
filename (string),project_id (string)
Project Upload Avatarproject.upload_avatarUpload a project avatar. Returns: the project with its new avatar_url. See also:
project.download_avatar,project.update.Required parameters:
filename (string),project_id (string)
Project Upload Deletedestructiveproject.upload_deleteDelete a project Markdown upload by its numeric upload ID. Returns: a success confirmation. See also:
project.upload_list,project.upload,project.get.Required parameters:
project_id (string),upload_id (integer)
Project Upload Delete By Secretdestructiveproject.upload_delete_by_secretDelete a project Markdown upload by its 32-character secret and filename (the /uploads/<secret>/<filename> reference). Returns: a success confirmation. See also:
project.upload_delete,project.upload_list,project.upload.Required parameters:
filename (string),project_id (string),secret (string)
Project Upload Listread-onlyproject.upload_listList all Markdown uploads in a project. Returns: each upload's id, filename, size, creation time, and uploader (id, username, name), plus pagination metadata. See also:
project.upload,project.upload_delete,project.get.Required parameters:
project_id (string)