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.

59 · actions7 · destructive31 · read-only

Counted with a Free-tier GitLab token. 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.

Back to the server card

1. issue.createIssue Create

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

2. issue.create_todoIssue Create Todo

   Create a to-do for an issue. Returns: the created to-do item with action, target, and state. See also: issue.get.

   Required parameters: issue_iid (integer), project_id (string)

3. issue.deleteIssue Deletedestructive

   Delete 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)

4. issue.discussion_add_noteAdd Issue Discussion Note

   Add 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)

5. issue.discussion_createCreate Issue Discussion

   Create 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)

6. issue.discussion_delete_noteDelete Issue Discussion Notedestructive

   Delete 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)

7. issue.discussion_getGet Issue Discussionread-only

   Get 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)

8. issue.discussion_listList Issue Discussionsread-only

   List 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)

9. issue.discussion_update_noteUpdate Issue Discussion Note

   Update 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)

10. issue.emoji_issue_createIssue Emoji Create

    Add 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)

11. issue.emoji_issue_deleteIssue Emoji Deletedestructive

    Remove 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)

12. issue.emoji_issue_getIssue Emoji Getread-only

    Get 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)

13. issue.emoji_issue_listIssue Emoji Listread-only

    List 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)

14. issue.emoji_issue_note_createIssue Note Emoji Create

    Add 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)

15. issue.emoji_issue_note_deleteIssue Note Emoji Deletedestructive

    Remove 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)

16. issue.emoji_issue_note_getIssue Note Emoji Getread-only

    Get 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)

17. issue.emoji_issue_note_listIssue Note Emoji Listread-only

    List 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)

18. issue.event_issue_label_getIssue Label Event Getread-only

    Get 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)

19. issue.event_issue_label_listIssue Label Event Listread-only

    List 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)

20. issue.event_issue_milestone_getIssue Milestone Event Getread-only

    Get 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)

21. issue.event_issue_milestone_listIssue Milestone Event Listread-only

    List 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)

22. issue.event_issue_state_getIssue State Event Getread-only

    Get 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), state_event_id (integer)

23. issue.event_issue_state_listIssue State Event Listread-only

    List 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)

24. issue.getIssue Getread-only

    Get 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)

25. issue.get_by_idIssue Get By IDread-only

    Get 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)

26. issue.link_createIssue Link Create

    Create 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), target_issue_iid (string), target_project_id (string)

27. issue.link_deleteIssue Link Deletedestructive

    Remove 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)

28. issue.link_getIssue Link Getread-only

    Get 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)

29. issue.link_listIssue Link Listread-only

    List 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)

30. issue.listIssue Listread-only

    List 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)

31. issue.list_allIssue List Allread-only

    List issues across accessible projects. Returns: visible issues with project context and pagination metadata. See also: issue.list, issue.list_group, search.issues.

    Required parameters: No required parameters

32. issue.list_groupIssue List Groupalias of group.issuesread-only

    List 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)

33. issue.moveIssue Move

    Move 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), to_project_id (integer)

34. issue.mrs_closingIssue MRs Closingread-only

    List 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)

35. issue.mrs_relatedIssue MRs Relatedread-only

    List MRs related to this issue. Returns: related merge requests with state, author, and branches. See also: issue.get, issue.mrs_closing.

    Required parameters: issue_iid (integer), project_id (string)

36. issue.note_createIssue Note Create

    Add 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)

37. issue.note_deleteIssue Note Deletedestructive

    Delete 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)

38. issue.note_getIssue Note Getread-only

    Get 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)

39. issue.note_listIssue Note Listread-only

    List 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)

40. issue.note_updateIssue Note Update

    Update 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)

41. issue.participantsIssue Participantsread-only

    List an issue's participants. Returns: participating users with username and name. See also: issue.get, issue.note_list.

    Required parameters: issue_iid (integer), project_id (string)

42. issue.reorderIssue Reorder

    Reorder an issue within its list. Returns: the updated issue. See also: issue.get, issue.list.

    Required parameters: issue_iid (integer), project_id (string)

43. issue.spent_time_addIssue Spent Time Add

    Add 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)

44. issue.spent_time_resetIssue Spent Time Reset

    Reset 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)

45. issue.statistics_getGet Issue Statisticsread-only

    Get global issue count statistics across all visible projects. 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

46. issue.statistics_get_groupGet Group Issue Statisticsread-only

    Get 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)

47. issue.statistics_get_projectGet Project Issue Statisticsread-only

    Get 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)

48. issue.subscribeIssue Subscribe

    Subscribe 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)

49. issue.time_estimate_resetIssue Time Estimate Reset

    Clear 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)

50. issue.time_estimate_setIssue Time Estimate Set

    Set 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)

51. issue.time_stats_getIssue Time Stats Getread-only

    Read 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)

52. issue.unsubscribeIssue Unsubscribe

    Unsubscribe 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)

53. issue.updateIssue Update

    Update 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)

54. issue.work_item_createCreate Work Item

    Create a new work item under a namespace. Returns: the created work item with id, iid, type, state, title, description, assignees, labels, linked items, child work items, 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)

55. issue.work_item_deleteDelete Work Itemdestructive

    Delete 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)

56. issue.work_item_getGet Work Itemread-only

    Get a single work item by namespace path and IID. Returns: id, iid, type, state, status, title, description, author, assignees, labels, linked items, child work items, 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)

57. issue.work_item_listList Work Itemsread-only

    List work items in a project or group namespace with filtering and cursor pagination. Returns: matching work items with type, state, title, author, labels, child work items, and timestamps. Experimental. See also: issue.work_item_get, issue.work_item_create, issue.work_item_type_list.

    Required parameters: full_path (string)

58. issue.work_item_type_listList Work Item Typesread-only

    List 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)

59. issue.work_item_updateUpdate Work Item

    Update 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, child work items, 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)