Action domain

access

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.

48 · actions9 · destructive19 · 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. access.approve_groupAccess Request Approve Group

   Approve a pending group access request, granting the user membership. Returns: the approved access request with id, username, name, granted access level, and approved state. See also: access.request_list_group, access.deny_group, group.members.

   Required parameters: group_id (string), user_id (integer)

2. access.approve_projectAccess Request Approve Project

   Approve a pending project access request, granting the user membership. Returns: the approved access request with id, username, name, granted access level, and approved state. See also: access.request_list_project, access.deny_project, project.members.

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

3. access.deny_groupAccess Request Deny Groupdestructive

   Deny a pending group access request, removing it without granting membership. Returns: a success status and confirmation message. See also: access.request_list_group, access.approve_group, group.members.

   Required parameters: group_id (string), user_id (integer)

4. access.deny_projectAccess Request Deny Projectdestructive

   Deny a pending project access request, removing it without granting membership. Returns: a success status and confirmation message. See also: access.request_list_project, access.approve_project, project.members.

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

5. access.deploy_key_addDeploy Key Add

   Add a new SSH deploy key to a project. Returns: the created deploy key with id, title, fingerprint, can_push, and expiry. See also: access.deploy_key_get, access.deploy_key_list_project, access.deploy_key_enable.

   Required parameters: key (string), project_id (string), title (string)

6. access.deploy_key_add_instanceDeploy Key Add Instance

   Create an instance-level deploy key (admin only). Returns: the created instance deploy key with id, title, fingerprint, expiry, and project access arrays. See also: access.deploy_key_list_all, access.deploy_key_enable.

   Required parameters: key (string), title (string)

7. access.deploy_key_deleteDeploy Key Deletedestructive

   Delete a deploy key from a project (removes it from all projects where it is enabled). Returns: a success confirmation. See also: access.deploy_key_get, access.deploy_key_list_project.

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

8. access.deploy_key_enableDeploy Key Enable

   Enable an existing deploy key for a project. Returns: the enabled deploy key with id, title, fingerprint, and can_push. See also: access.deploy_key_list_all, access.deploy_key_list_project, access.deploy_key_get.

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

9. access.deploy_key_getDeploy Key Getread-only

   Get a single project deploy key by id. Returns: the deploy key with title, key, fingerprint, fingerprint_sha256, can_push, created_at, and expires_at. See also: access.deploy_key_list_project, access.deploy_key_update, access.deploy_key_delete.

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

10. access.deploy_key_list_allDeploy Key List Allread-only

    List ALL instance-level SSH deploy keys in one call (admin only). Use this instead of gitlab_deploy_key_list_project when you need every key on the instance. Returns: instance deploy keys with id, title, fingerprint, expiry, projects_with_write_access, projects_with_readonly_access, and pagination metadata. See also: access.deploy_key_add_instance, access.deploy_key_enable, access.deploy_key_list_project.

    Required parameters: No required parameters

11. access.deploy_key_list_projectDeploy Key List Projectread-only

    List a project's SSH deploy keys with ordering and pagination. Returns: deploy keys with id, title, fingerprint, can_push, expiry, and pagination metadata. See also: access.deploy_key_get, access.deploy_key_add, access.deploy_key_enable.

    Required parameters: project_id (string)

12. access.deploy_key_list_user_projectDeploy Key List User Projectread-only

    List the deploy keys across a user's projects (admin only) with ordering and pagination. Returns: deploy keys with id, title, fingerprint, can_push, expiry, and pagination metadata. See also: access.deploy_key_list_project, access.deploy_key_get, user.get.

    Required parameters: user_id (string)

13. access.deploy_key_updateDeploy Key Update

    Update a project deploy key's title or push permission. Returns: the updated deploy key. See also: access.deploy_key_get, access.deploy_key_list_project, access.deploy_key_delete.

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

14. access.deploy_token_create_groupDeploy Token Create Group

    Create a deploy token for a group. Returns: the created deploy token including its one-time secret token value, plus id, name, username, scopes, and expiry. See also: access.deploy_token_list_group, access.deploy_token_get_group, access.deploy_token_delete_group.

    Required parameters: group_id (string), name (string)

15. access.deploy_token_create_projectDeploy Token Create Project

    Create a deploy token for a project. Returns: the created deploy token including its one-time secret token value, plus id, name, username, scopes, and expiry. See also: access.deploy_token_list_project, access.deploy_token_get_project, access.deploy_token_delete_project.

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

16. access.deploy_token_delete_groupDeploy Token Delete Groupdestructive

    Permanently delete a group deploy token by ID. Returns: a success confirmation. Deletion is irreversible. See also: access.deploy_token_list_group, access.deploy_token_get_group, access.deploy_token_create_group.

    Required parameters: deploy_token_id (integer), group_id (string)

17. access.deploy_token_delete_projectDeploy Token Delete Projectdestructive

    Permanently delete a project deploy token by ID. Returns: a success confirmation. Deletion is irreversible. See also: access.deploy_token_list_project, access.deploy_token_get_project, access.deploy_token_create_project.

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

18. access.deploy_token_get_groupDeploy Token Get Groupread-only

    Get a single group deploy token by ID. Returns: the deploy token with id, name, username, scopes, revoked/expired state, and expiry. See also: access.deploy_token_list_group, access.deploy_token_create_group, access.deploy_token_delete_group.

    Required parameters: deploy_token_id (integer), group_id (string)

19. access.deploy_token_get_projectDeploy Token Get Projectread-only

    Get a single project deploy token by ID. Returns: the deploy token with id, name, username, scopes, revoked/expired state, and expiry. See also: access.deploy_token_list_project, access.deploy_token_create_project, access.deploy_token_delete_project.

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

20. access.deploy_token_list_allDeploy Token List Allread-only

    List ALL deploy tokens across the GitLab instance in one call (admin only). Use this instead of gitlab_deploy_token_list_project or gitlab_deploy_token_list_group when you need every instance-wide token. Returns: deploy tokens with id, name, username, scopes, revoked/expired state, and pagination metadata. See also: access.deploy_token_list_project, access.deploy_token_list_group, access.deploy_token_create_project.

    Required parameters: No required parameters

21. access.deploy_token_list_groupDeploy Token List Groupread-only

    List deploy tokens owned by a group. Returns: deploy tokens with id, name, username, scopes, revoked/expired state, expiry, and pagination metadata. See also: access.deploy_token_get_group, access.deploy_token_create_group, access.deploy_token_delete_group.

    Required parameters: group_id (string)

22. access.deploy_token_list_projectDeploy Token List Projectread-only

    List deploy tokens owned by a project. Returns: deploy tokens with id, name, username, scopes, revoked/expired state, expiry, and pagination metadata. See also: access.deploy_token_get_project, access.deploy_token_create_project, access.deploy_token_delete_project.

    Required parameters: project_id (string)

23. access.invite_groupGroup Invite

    Invite a user to a group by email or user ID with an access level. Returns: an invitation result with status and per-email messages. See also: access.invite_list_group, group.group_member_add, access.request_group.

    Required parameters: access_level (integer), group_id (string)

24. access.invite_list_groupGroup Invite List Pendingread-only

    List a group's pending invitations. Returns: pending invitations with invite email, access level, creator, creation and expiry dates, plus pagination metadata. See also: access.invite_group, group.members.

    Required parameters: group_id (string)

25. access.invite_list_projectProject Invite List Pendingread-only

    List a project's pending invitations. Returns: pending invitations with invite email, access level, creator, creation and expiry dates, plus pagination metadata. See also: access.invite_project, project.members.

    Required parameters: project_id (string)

26. access.invite_projectProject Invite

    Invite a user to a project by email or user ID with an access level. Returns: an invitation result with status and per-email messages. See also: access.invite_list_project, project.member_add, access.request_project.

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

27. access.request_groupAccess Request Request Group

    Request access to a group as the authenticated user. Returns: the created access request with id, username, name, requested state, and requested_at timestamp. See also: access.request_list_group, access.approve_group, access.deny_group.

    Required parameters: group_id (string)

28. access.request_list_groupAccess Request List Groupread-only

    List pending access requests for a group. Returns: access requests with id, username, name, state, access level, requested/created timestamps, and pagination metadata. See also: access.approve_group, access.deny_group, group.members.

    Required parameters: group_id (string)

29. access.request_list_projectAccess Request List Projectread-only

    List pending access requests for a project. Returns: access requests with id, username, name, state, access level, requested/created timestamps, and pagination metadata. See also: access.approve_project, access.deny_project, project.members.

    Required parameters: project_id (string)

30. access.request_projectAccess Request Request Project

    Request access to a project as the authenticated user. Returns: the created access request with id, username, name, requested state, and requested_at timestamp. See also: access.request_list_project, access.approve_project, access.deny_project.

    Required parameters: project_id (string)

31. access.token_group_createGroup Access Token Create

    Use for GitLab group access tokens: this action creates a group-scoped API token.

    Required parameters: group_id (string), name (string), scopes (array)

32. access.token_group_getGroup Access Token Getread-only

    Use for GitLab group access tokens: this action gets a group-scoped API token.

    Required parameters: group_id (string), token_id (integer)

33. access.token_group_listGroup Access Token Listread-only

    Use for GitLab group access tokens: this action lists group-scoped API tokens.

    Required parameters: group_id (string)

34. access.token_group_revokeGroup Access Token Revokedestructive

    Use for GitLab group access tokens: this action revokes a group-scoped API token.

    Required parameters: group_id (string), token_id (integer)

35. access.token_group_rotateGroup Access Token Rotate

    Use for GitLab group access tokens: this action rotates a group-scoped API token.

    Required parameters: group_id (string), token_id (integer)

36. access.token_group_rotate_selfGroup Access Token Rotate Self

    Use for GitLab group access tokens: this action rotates the group-scoped token that authenticates this request itself, with no token_id parameter.

    Required parameters: group_id (string)

37. access.token_personal_getPersonal Access Token Getread-only

    Use for GitLab personal access tokens: this action gets a personal-scoped API token.

    Required parameters: No required parameters

38. access.token_personal_listPersonal Access Token Listread-only

    Use for GitLab personal access tokens: this action lists personal-scoped API tokens.

    Required parameters: No required parameters

39. access.token_personal_revokePersonal Access Token Revokedestructive

    Use for GitLab personal access tokens: this action revokes a personal-scoped API token.

    Required parameters: token_id (integer)

40. access.token_personal_revoke_selfPersonal Access Token Revoke Selfdestructive

    Use for GitLab personal access tokens: this action revokes the personal-scoped token that authenticates this request itself, with no token_id parameter.

    Required parameters: No required parameters

41. access.token_personal_rotatePersonal Access Token Rotate

    Use for GitLab personal access tokens: this action rotates a personal-scoped API token.

    Required parameters: token_id (integer)

42. access.token_personal_rotate_selfPersonal Access Token Rotate Self

    Use for GitLab personal access tokens: this action rotates the personal-scoped token that authenticates this request itself, with no token_id parameter.

    Required parameters: No required parameters

43. access.token_project_createProject Access Token Create

    Use for GitLab project access tokens: this action creates a project-scoped API token.

    Required parameters: name (string), project_id (string), scopes (array)

44. access.token_project_getProject Access Token Getread-only

    Use for GitLab project access tokens: this action gets a project-scoped API token.

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

45. access.token_project_listProject Access Token Listread-only

    Use for GitLab project access tokens: this action lists project-scoped API tokens.

    Required parameters: project_id (string)

46. access.token_project_revokeProject Access Token Revokedestructive

    Use for GitLab project access tokens: this action revokes a project-scoped API token.

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

47. access.token_project_rotateProject Access Token Rotate

    Use for GitLab project access tokens: this action rotates a project-scoped API token.

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

48. access.token_project_rotate_selfProject Access Token Rotate Self

    Use for GitLab project access tokens: this action rotates the project-scoped token that authenticates this request itself, with no token_id parameter.

    Required parameters: project_id (string)