Action domain
issue
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.
66 · actions8 · destructive33 · 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 counts 868 operations on Community Edition and up to 1,094 on GitLab.com's top tier, while this deployment publishes 768 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.
Each entry also says what a GitLab fine-grained personal access token needs to run it, as GitLab 19.4.1 declares it: every permission of one line, at one of the boundaries named. Where there are alternatives, any one is enough.
Issue Createissue.createCreate a new issue in a project. Returns: the created issue with IID, state, labels, assignees, milestone, due date, and web URL. See also:
issue.get,issue.list,issue.update.Required parameters:
project_id (string|integer),title (string)Fine-grained token:
Work Item: Createat project
Issue Create Todoissue.create_todoCreate a to-do for an issue. Returns: the created to-do item with action, target title and URL, author, body, state and created and updated times. See also:
issue.get.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Todo: Createat project
Issue Deletedestructiveissue.deleteDelete an issue permanently. Returns: a success confirmation naming the issue and project. See also:
issue.get,issue.update.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Deleteat project
Add Issue Discussion Noteissue.discussion_add_noteAdd a reply note to an existing issue discussion thread. Returns: the created note (author, body, timestamps). See also:
issue.discussion_create,issue.discussion_get,issue.discussion_update_note.Required parameters:
body (string),discussion_id (string),issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Createat project
Create Issue Discussionissue.discussion_createCreate a new discussion thread on an issue with an initial note. Returns: the created thread with its first note. See also:
issue.discussion_add_note,issue.discussion_list,issue.note_create.Required parameters:
body (string),issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Createat project
Delete Issue Discussion Notedestructiveissue.discussion_delete_noteDelete a note from an issue discussion thread (destructive). Returns: a deletion confirmation message. See also:
issue.discussion_update_note,issue.discussion_get,issue.discussion_list.Required parameters:
discussion_id (string),issue_iid (integer),note_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Deleteat project
Get Issue Discussionread-onlyissue.discussion_getGet a single issue discussion thread by its discussion id. Returns: the thread with every note (author, body, system flag, resolvable/resolved state). See also:
issue.discussion_list,issue.discussion_add_note,issue.get.Required parameters:
discussion_id (string),issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
List Issue Discussionsread-onlyissue.discussion_listList discussion threads on an issue with ordering and keyset pagination. Returns: discussion threads with their notes (author, body, system flag, resolvable state) and pagination metadata. See also:
issue.discussion_get,issue.discussion_create,issue.get,issue.note_list.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Update Issue Discussion Noteissue.discussion_update_noteUpdate the body of a note in an issue discussion thread. Returns: the updated note. See also:
issue.discussion_add_note,issue.discussion_delete_note,issue.discussion_get.Required parameters:
body (string),discussion_id (string),issue_iid (integer),note_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Updateat project
Issue Emoji Createissue.emoji_issue_createAdd an emoji reaction to an issue. Returns: the created award with its emoji name, awarding user object, timestamps, and awardable id/type. See also:
issue.emoji_issue_list,issue.emoji_issue_delete.Required parameters:
issue_iid (integer),name (string),project_id (string|integer)Fine-grained token:
Work Item: Createat project
Issue Emoji Deletedestructiveissue.emoji_issue_deleteRemove an emoji reaction from an issue by award id. Returns: a success confirmation naming the award emoji. See also:
issue.emoji_issue_list,issue.emoji_issue_get.Required parameters:
award_id (integer),issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Deleteat project
Issue Emoji Getread-onlyissue.emoji_issue_getGet a single emoji reaction on an issue by award id. Returns: the award with its emoji name, awarding user object, timestamps, and awardable id/type. See also:
issue.emoji_issue_list,issue.emoji_issue_delete.Required parameters:
award_id (integer),issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Emoji Listread-onlyissue.emoji_issue_listList all emoji reactions on an issue. Returns: each award with its emoji name, the awarding user object, awardable id/type, and pagination metadata. See also:
issue.emoji_issue_get,issue.emoji_issue_create,issue.get.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Note Emoji Createissue.emoji_issue_note_createAdd an emoji reaction to an issue note. Returns: the created award with its emoji name, awarding user object, timestamps, and awardable id/type. See also:
issue.emoji_issue_note_list,issue.emoji_issue_note_delete.Required parameters:
issue_iid (integer),name (string),note_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Createat project
Issue Note Emoji Deletedestructiveissue.emoji_issue_note_deleteRemove an emoji reaction from an issue note by award id. Returns: a success confirmation naming the award emoji. See also:
issue.emoji_issue_note_list,issue.emoji_issue_note_get.Required parameters:
award_id (integer),issue_iid (integer),note_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Deleteat project
Issue Note Emoji Getread-onlyissue.emoji_issue_note_getGet a single emoji reaction on an issue note by award id. Returns: the award with its emoji name, awarding user object, timestamps, and awardable id/type. See also:
issue.emoji_issue_note_list,issue.emoji_issue_note_delete.Required parameters:
award_id (integer),issue_iid (integer),note_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Note Emoji Listread-onlyissue.emoji_issue_note_listList all emoji reactions on an issue note (comment). Returns: each award with its emoji name, the awarding user object, awardable id/type, and pagination metadata. See also:
issue.emoji_issue_note_get,issue.emoji_issue_note_create,issue.note_get.Required parameters:
issue_iid (integer),note_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Label Event Getread-onlyissue.event_issue_label_getGet a single label event for an issue. Returns: the event with action, the label object, and the acting user. See also:
issue.event_issue_label_list.Required parameters:
issue_iid (integer),label_event_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Label Event Listread-onlyissue.event_issue_label_listList label events for an issue. Returns: label events with action, the label object, the acting user, and pagination metadata. See also:
issue.event_issue_label_get,issue.get.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Milestone Event Getread-onlyissue.event_issue_milestone_getGet a single milestone event for an issue. Returns: the event with action, the milestone object, and the acting user. See also:
issue.event_issue_milestone_list.Required parameters:
issue_iid (integer),milestone_event_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Milestone Event Listread-onlyissue.event_issue_milestone_listList milestone events for an issue. Returns: milestone events with action, the milestone object, the acting user, and pagination metadata. See also:
issue.event_issue_milestone_get,issue.get.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue State Event Getread-onlyissue.event_issue_state_getGet a single state event for an issue. Returns: the event with the state value and the acting user. See also:
issue.event_issue_state_list.Required parameters:
issue_iid (integer),project_id (string|integer),state_event_id (integer)Fine-grained token:
Work Item: Readat project
Issue State Event Listread-onlyissue.event_issue_state_listList state events for an issue. Returns: state events with the state value, the acting user, and pagination metadata. See also:
issue.event_issue_state_get,issue.get.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Getread-onlyissue.getGet a single issue from a project by issue IID. Returns: issue metadata, state, labels, assignees, author, due date, task completion, and web URL. See also:
issue.list,issue.update,issue.delete,issue.note_list.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Get By IDread-onlyissue.get_by_idGet a single issue by its global ID. Returns: the issue with state, labels, assignees, author, and web URL. See also:
issue.get,issue.list.Required parameters:
issue_id (integer)Fine-grained token:
Work Item: Readat instance
Issue Link Createissue.link_createCreate a link between two issues (optionally across projects). Returns: the created link with its id, link_type, and source_issue/target_issue objects. See also:
issue.link_list,issue.link_delete,issue.get.Required parameters:
issue_iid (integer),project_id (string|integer),target_issue_iid (string),target_project_id (string)Fine-grained token:
Work Item: Createat project
Issue Link Deletedestructiveissue.link_deleteRemove an existing issue link by its issue_link_id. Returns: a deletion confirmation. See also:
issue.link_list,issue.link_create,issue.get.Required parameters:
issue_iid (integer),issue_link_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Deleteat project
Issue Link Getread-onlyissue.link_getGet one issue link by its issue_link_id. Returns: the link's id, link_type, and full source_issue/target_issue objects. See also:
issue.link_list,issue.link_create,issue.get.Required parameters:
issue_iid (integer),issue_link_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Link Listread-onlyissue.link_listList all issues linked to a source issue. Returns: each linked issue with its link_type, issue_link_id, full author/assignee/milestone objects, labels, and dates. See also:
issue.link_get,issue.link_create,issue.get.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Listread-onlyissue.listList issues in one project with filtering and pagination. Returns: matching issues with state, labels, assignees, author, and pagination metadata. See also:
issue.get,issue.create,search.issues.Required parameters:
project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue List Allread-onlyissue.list_allList issues across projects: only the ones the caller created when scope is omitted, since GitLab defaults to scope=created_by_me, and every issue the caller can see with scope=all. Returns: the matching issues with project context and pagination metadata. See also:
issue.list,issue.list_group,search.issues.Required parameters: No required parameters
Fine-grained token:
Work Item: Readat user
Issue List Groupalias ofissue.list_groupgroup.issuesread-onlyList issues across a group and its subgroups and projects. Use when work is scoped to a group rather than a single project.
Required parameters:
group_id (string|integer)Fine-grained token:
Work Item: Readat group
Issue Moveissue.moveMove an issue to another project. Returns: the issue in its new project. See also:
issue.get,issue.update.Required parameters:
issue_iid (integer),project_id (string|integer),to_project_id (integer)Fine-grained token:
Work Item: Updateat project
Issue MRs Closingread-onlyissue.mrs_closingList MRs that close this issue on merge. Returns: related merge requests with state, author, and branches. See also:
issue.get,issue.mrs_related.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Note Createissue.note_createAdd a comment (note) to an issue. Returns: the created note with id, author, body, timestamps, and resolvable/internal flags. See also:
issue.note_list,issue.get,issue.discussion_create.Required parameters:
body (string),issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Createat project
Issue Note Deletedestructiveissue.note_deleteDelete an issue note permanently. Returns: a success confirmation naming the note, issue, and project. See also:
issue.note_get,issue.note_list.Required parameters:
issue_iid (integer),note_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Deleteat project
Issue Note Getread-onlyissue.note_getGet a single issue note by its ID. Returns: the note with author, body, timestamps, position, and resolvable/internal flags. See also:
issue.note_list,issue.note_update,issue.note_delete.Required parameters:
issue_iid (integer),note_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Note Listread-onlyissue.note_listList all notes (comments) on an issue. Returns: notes with author, body, system/internal flags, and pagination metadata. See also:
issue.note_get,issue.note_create,issue.discussion_get.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Note Updateissue.note_updateUpdate an issue note's body. Returns: the updated note with new body and updated_at timestamp. See also:
issue.note_get,issue.note_list,issue.note_delete.Required parameters:
body (string),issue_iid (integer),note_id (integer),project_id (string|integer)Fine-grained token:
Work Item: Updateat project
Issue Participantsread-onlyissue.participantsList an issue's participants. Returns: participating users with ID, username, name, state, locked flag, public email, avatar and profile URL, with pagination metadata. See also:
issue.get,issue.note_list.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Reorderissue.reorderReorder an issue within its list. Returns: the updated issue. See also:
issue.get,issue.list.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Updateat project
Issue Spent Time Addissue.spent_time_addAdd spent time to an issue. Returns: the updated time tracking stats. See also:
issue.spent_time_reset,issue.time_stats_get.Required parameters:
duration (string),issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Updateat project
Issue Spent Time Resetissue.spent_time_resetReset an issue's spent time. Returns: the updated time tracking stats. See also:
issue.spent_time_add,issue.time_stats_get.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Updateat project
Get Issue Statisticsread-onlyissue.statistics_getGet global issue count statistics: of the issues the caller created when scope is omitted, since GitLab defaults to scope=created_by_me, and of every issue the caller can see with scope=all. Returns: a statistics object with nested counts (all, opened, closed). See also:
issue.statistics_get_group,issue.statistics_get_project,issue.list.Required parameters: No required parameters
Fine-grained token:
Work Item: Readat user
Get Group Issue Statisticsread-onlyissue.statistics_get_groupGet issue count statistics for a group and its descendant projects. Returns: a statistics object with nested counts (all, opened, closed). See also:
issue.statistics_get,issue.statistics_get_project,group.get.Required parameters:
group_id (string)Fine-grained token:
Work Item: Readat group
Get Project Issue Statisticsread-onlyissue.statistics_get_projectGet issue count statistics for a single project. Returns: a statistics object with nested counts (all, opened, closed). See also:
issue.statistics_get,issue.statistics_get_group,project.get.Required parameters:
project_id (string)Fine-grained token:
Work Item: Readat project
Issue Subscribeissue.subscribeSubscribe to an issue's notifications. Returns: the issue with the updated subscription state. See also:
issue.get,issue.unsubscribe.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Issue: Subscribeat project
Issue Time Estimate Resetissue.time_estimate_resetClear an issue's time estimate. Returns: the updated time tracking stats. See also:
issue.time_estimate_set,issue.time_stats_get.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Updateat project
Issue Time Estimate Setissue.time_estimate_setSet an issue's time estimate. Returns: the updated time tracking stats. See also:
issue.time_estimate_reset,issue.time_stats_get.Required parameters:
duration (string),issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Updateat project
Issue Time Stats Getread-onlyissue.time_stats_getRead an issue's time tracking totals. Returns: estimate and spent time in seconds and human-readable form. See also:
issue.time_estimate_set,issue.spent_time_add.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Readat project
Issue Unsubscribeissue.unsubscribeUnsubscribe from an issue's notifications. Returns: the issue with the updated subscription state. See also:
issue.get,issue.subscribe.Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Issue: Subscribeat project
Issue Updateissue.updateUpdate issue fields. To close or reopen an issue with issue.update, set params.state_event to close or reopen. Dynamic execute also accepts issue.close and issue.reopen aliases that fill state_event automatically.
Required parameters:
issue_iid (integer),project_id (string|integer)Fine-grained token:
Work Item: Updateat project
Create Work Itemissue.work_item_createCreate a new work item under a namespace. Returns: the created work item with id, iid, type, state, title, description, assignees, labels, linked items, parent and child work items, milestone, iteration, weight, health status, color, start and due dates, and web URL. Experimental. See also:
issue.work_item_get,issue.work_item_list,issue.work_item_type_list.Required parameters:
full_path (string),title (string),work_item_type_id (string)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
Delete Work Itemdestructiveissue.work_item_deleteDelete a work item permanently by namespace path and IID. Returns: a success confirmation naming the work item and namespace. Experimental. See also:
issue.work_item_get,issue.work_item_update.Required parameters:
full_path (string),work_item_iid (integer)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
Get Work Itemread-onlyissue.work_item_getGet a single work item by namespace path and IID. Returns: id, iid, type, state, status, title, description, author, assignees, labels, linked items, parent and child work items, milestone, iteration, weight, health status, color, start and due dates, confidentiality, timestamps, and web URL. Experimental. See also:
issue.work_item_list,issue.work_item_update,issue.work_item_delete.Required parameters:
full_path (string),work_item_iid (integer)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
List Work Itemsread-onlyissue.work_item_listList work items in a project or group namespace with filtering and cursor pagination. Returns: matching work items with type, state, title, author, assignees, labels, linked items, parent and child work items, milestone, start and due dates, timestamps, and the cursors for the next and previous pages. On Premium and Ultimate instances the status, weight, health status, iteration and color of each item come back too. returned_fields narrows that set to the fields named, which shrinks a large page without changing which work items match. Pages in both directions: first with after walks forward, last with before walks back. Experimental. See also:
issue.work_item_get,issue.work_item_create,issue.work_item_type_list.Required parameters:
full_path (string)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
Work Item Saved View Createissue.work_item_saved_view_createCreate a work item saved view under a namespace. Returns: the created view with id, global id, name, private flag, subscription state, sort order, filters, and display settings. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also:
issue.work_item_saved_view_list,issue.work_item_saved_view_update,issue.work_item_saved_view_get.Required parameters:
name (string),namespace_path (string),sort (string)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
Work Item Saved View Deletedestructiveissue.work_item_saved_view_deleteDelete a work item saved view permanently by numeric ID. Returns: a success confirmation naming the view. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also:
issue.work_item_saved_view_get,issue.work_item_saved_view_list.Required parameters:
saved_view_id (integer)Fine-grained token:
Work Item Saved View: Deleteat project or group
Work Item Saved View Getread-onlyissue.work_item_saved_view_getGet a single work item saved view by namespace path and numeric ID. Returns: id, global id, name, description, private flag, subscription state, sort order, filters, and display settings. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also:
issue.work_item_saved_view_list,issue.work_item_saved_view_update,issue.work_item_saved_view_delete.Required parameters:
namespace_path (string),saved_view_id (integer)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
Work Item Saved View Listread-onlyissue.work_item_saved_view_listList work item saved views for a group or project namespace with cursor pagination. Returns: id, name, description, private flag, subscription state, and sort order per view, plus pagination cursors. Filters are omitted here, so read one view with
issue.work_item_saved_view_get. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also:issue.work_item_saved_view_get,issue.work_item_saved_view_create,issue.work_item_list.Required parameters:
namespace_path (string)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
Work Item Saved View Subscribeissue.work_item_saved_view_subscribeSubscribe the authenticated user to a work item saved view. Returns: the view with the updated subscription state. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also:
issue.work_item_saved_view_unsubscribe,issue.work_item_saved_view_get,issue.work_item_saved_view_list.Required parameters:
saved_view_id (integer)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
Work Item Saved View Unsubscribeissue.work_item_saved_view_unsubscribeUnsubscribe the authenticated user from a work item saved view. Returns: the view with the updated subscription state. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also:
issue.work_item_saved_view_subscribe,issue.work_item_saved_view_get,issue.work_item_saved_view_list.Required parameters:
saved_view_id (integer)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
Work Item Saved View Updateissue.work_item_saved_view_updateUpdate a work item saved view by numeric ID. Returns: the updated view with id, global id, name, private flag, subscription state, sort order, filters, and display settings. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also:
issue.work_item_saved_view_get,issue.work_item_saved_view_list,issue.work_item_saved_view_delete.Required parameters:
saved_view_id (integer)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
List Work Item Typesread-onlyissue.work_item_type_listList work item types for a namespace. Returns: id, name, and enabled flag for each type. Supports name filter, only_available flag, and cursor pagination. Experimental. See also:
issue.work_item_list,issue.work_item_create.Required parameters:
full_path (string)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token
Update Work Itemissue.work_item_updateUpdate an existing work item by namespace path and IID. Returns: the updated work item with id, iid, type, state, status, title, description, assignees, labels, linked items, parent and child work items, milestone, iteration, weight, health status, color, start and due dates, and web URL. Experimental. See also:
issue.work_item_get,issue.work_item_delete,issue.work_item_list.Required parameters:
full_path (string),work_item_iid (integer)Fine-grained token: none can run it at this GitLab release, which declares nothing for it; use a classic token