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 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. issue.create

   Issue 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_todo

   Issue 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.delete

   Issue 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_note

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

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

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

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

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

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

    Issue 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_delete

    Issue 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_get

    Issue 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_list

    Issue 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_create

    Issue 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_delete

    Issue 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_get

    Issue 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_list

    Issue 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_get

    Issue 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_list

    Issue 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_get

    Issue 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_list

    Issue 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_get

    Issue 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_list

    Issue 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.get

    Issue 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_id

    Issue 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_create

    Issue 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_delete

    Issue 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_get

    Issue 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_list

    Issue 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.list

    Issue 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_all

    Issue 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_group

    Issue 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.move

    Issue 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_closing

    Issue 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_related

    Issue 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_create

    Issue 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_delete

    Issue 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_get

    Issue 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_list

    Issue 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_update

    Issue 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.participants

    Issue 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.reorder

    Issue 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_add

    Issue 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_reset

    Issue 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_get

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

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

    Get 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.subscribe

    Issue 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_reset

    Issue 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_set

    Issue 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_get

    Issue 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.unsubscribe

    Issue 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.update

    Issue 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_create

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

55. issue.work_item_delete

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

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

57. issue.work_item_list

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

58. issue.work_item_saved_view_create

    Work Item Saved View Create

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

59. issue.work_item_saved_view_delete

    Work Item Saved View Deletedestructive

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

60. issue.work_item_saved_view_get

    Work Item Saved View Getread-only

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

61. issue.work_item_saved_view_list

    Work Item Saved View Listread-only

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

62. issue.work_item_saved_view_subscribe

    Work Item Saved View Subscribe

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

63. issue.work_item_saved_view_unsubscribe

    Work Item Saved View Unsubscribe

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

64. issue.work_item_saved_view_update

    Work Item Saved View Update

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

65. issue.work_item_type_list

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

66. issue.work_item_update

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