Dominio de acciones

access

Todas las acciones que este dominio expone vía gitlab_execute_action, del manifiesto gitlab://tools. Cada entrada se despliega a su descripción completa y sus parámetros obligatorios.

48 · acciones9 · destructivas19 · solo lectura

Contado con un token Free contra gitlab.com, que es el único host con el que habla este endpoint: para usarlo contra una instancia self-managed, levanta tú el servidor — su documentación lo cubre. El catálogo depende del token que pregunta, así que el recuento se mueve con su tier y con sus permisos: los tiers superiores exponen más acciones, y los dominios de administración solo aparecen a tokens autorizados a usarlos. Por eso las cifras difieren en otros sitios: el proyecto upstream cuenta 868 operaciones en Community Edition y hasta 1.094 en el tier más alto de GitLab.com, mientras que este despliegue publica 768 porque es solo-OAuth y actúa con tu token, así que los dominios de administración que una cuenta sin admin no puede llamar no aparecen nunca. Las tres describen el mismo catálogo, contado desde tres sitios distintos.

Cada entrada dice también qué necesita un token de acceso personal fine-grained de GitLab para ejecutarla, tal como lo declara GitLab 19.4.1: todos los permisos de una línea, en uno de los ámbitos indicados. Cuando hay alternativas, basta con cualquiera.

Volver a la ficha del servidor

1. access.approve_group

   Access Request Approve Group

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

   Parámetros obligatorios: group_id (string|integer), user_id (integer)

   Token fine-grained: Access Request: Approve en grupo

2. access.approve_project

   Access Request Approve Project

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

   Parámetros obligatorios: project_id (string|integer), user_id (integer)

   Token fine-grained: Access Request: Approve en proyecto

3. access.deny_group

   Access Request Deny Groupdestructiva

   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.

   Parámetros obligatorios: group_id (string|integer), user_id (integer)

   Token fine-grained: Access Request: Delete en grupo o usuario

4. access.deny_project

   Access Request Deny Projectdestructiva

   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.

   Parámetros obligatorios: project_id (string|integer), user_id (integer)

   Token fine-grained: Access Request: Delete en proyecto o usuario

5. access.deploy_key_add

   Deploy 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.

   Parámetros obligatorios: key (string), project_id (string|integer), title (string)

   Token fine-grained: Deploy Key: Create en proyecto

6. access.deploy_key_add_instance

   Deploy 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.

   Parámetros obligatorios: key (string), title (string)

   Token fine-grained: Deploy Key: Create en instancia

7. access.deploy_key_delete

   Deploy Key Deletedestructiva

   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.

   Parámetros obligatorios: deploy_key_id (integer), project_id (string|integer)

   Token fine-grained: Deploy Key: Delete en proyecto

8. access.deploy_key_enable

   Deploy 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.

   Parámetros obligatorios: deploy_key_id (integer), project_id (string|integer)

   Token fine-grained: Deploy Key: Enable en proyecto

9. access.deploy_key_get

   Deploy Key Getsolo lectura

   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.

   Parámetros obligatorios: deploy_key_id (integer), project_id (string|integer)

   Token fine-grained: Deploy Key: Read en proyecto

10. access.deploy_key_list_all

    Deploy Key List Allsolo lectura

    List ALL instance-level SSH deploy keys in one call (admin only). Use this instead of access.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.

    Parámetros obligatorios: Sin parámetros obligatorios

    Token fine-grained: Deploy Key: Read en instancia

11. access.deploy_key_list_project

    Deploy Key List Projectsolo lectura

    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.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Deploy Key: Read en proyecto

12. access.deploy_key_list_user_project

    Deploy Key List User Projectsolo lectura

    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.

    Parámetros obligatorios: user_id (string|integer)

    Token fine-grained: Deploy Key: Read en usuario

13. access.deploy_key_update

    Deploy 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.

    Parámetros obligatorios: deploy_key_id (integer), project_id (string|integer)

    Token fine-grained: Deploy Key: Update en proyecto

14. access.deploy_token_create_group

    Deploy 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.

    Parámetros obligatorios: group_id (string|integer), name (string)

    Token fine-grained: Deploy Token: Create en grupo

15. access.deploy_token_create_project

    Deploy 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.

    Parámetros obligatorios: name (string), project_id (string|integer)

    Token fine-grained: Deploy Token: Create en proyecto

16. access.deploy_token_delete_group

    Deploy Token Delete Groupdestructiva

    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.

    Parámetros obligatorios: deploy_token_id (integer), group_id (string|integer)

    Token fine-grained: Deploy Token: Delete en grupo

17. access.deploy_token_delete_project

    Deploy Token Delete Projectdestructiva

    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.

    Parámetros obligatorios: deploy_token_id (integer), project_id (string|integer)

    Token fine-grained: Deploy Token: Delete en proyecto

18. access.deploy_token_get_group

    Deploy Token Get Groupsolo lectura

    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.

    Parámetros obligatorios: deploy_token_id (integer), group_id (string|integer)

    Token fine-grained: Deploy Token: Read en grupo

19. access.deploy_token_get_project

    Deploy Token Get Projectsolo lectura

    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.

    Parámetros obligatorios: deploy_token_id (integer), project_id (string|integer)

    Token fine-grained: Deploy Token: Read en proyecto

20. access.deploy_token_list_all

    Deploy Token List Allsolo lectura

    List ALL deploy tokens across the GitLab instance in one call (admin only). Use this instead of access.deploy_token_list_project or access.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.

    Parámetros obligatorios: Sin parámetros obligatorios

    Token fine-grained: Deploy Token: Read en instancia

21. access.deploy_token_list_group

    Deploy Token List Groupsolo lectura

    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.

    Parámetros obligatorios: group_id (string|integer)

    Token fine-grained: Deploy Token: Read en grupo

22. access.deploy_token_list_project

    Deploy Token List Projectsolo lectura

    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.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Deploy Token: Read en proyecto

23. access.invite_group

    Group Invite

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

    Parámetros obligatorios: access_level (integer), group_id (string|integer)

    Token fine-grained: Invitation: Create en grupo

24. access.invite_list_group

    Group Invite List Pendingsolo lectura

    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.

    Parámetros obligatorios: group_id (string|integer)

    Token fine-grained: Invitation: Read en grupo

25. access.invite_list_project

    Project Invite List Pendingsolo lectura

    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.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Invitation: Read en proyecto

26. access.invite_project

    Project Invite

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

    Parámetros obligatorios: access_level (integer), project_id (string|integer)

    Token fine-grained: Invitation: Create en proyecto

27. access.request_group

    Access 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.

    Parámetros obligatorios: group_id (string|integer)

    Token fine-grained: Access Request: Create en usuario

28. access.request_list_group

    Access Request List Groupsolo lectura

    List pending access requests for a group. Returns: access requests with id, username, name, state, whether the account is locked, the address the user publishes, the requested_at timestamp, and pagination metadata. A pending request carries no access level: GitLab grants one when it is approved. See also: access.approve_group, access.deny_group, group.members.

    Parámetros obligatorios: group_id (string|integer)

    Token fine-grained: Access Request: Read en grupo

29. access.request_list_project

    Access Request List Projectsolo lectura

    List pending access requests for a project. Returns: access requests with id, username, name, state, whether the account is locked, the address the user publishes, the requested_at timestamp, and pagination metadata. A pending request carries no access level: GitLab grants one when it is approved. See also: access.approve_project, access.deny_project, project.members.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Access Request: Read en proyecto

30. access.request_project

    Access 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.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Access Request: Create en usuario

31. access.token_group_create

    Group Access Token Create

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

    Parámetros obligatorios: group_id (string|integer), name (string), scopes (array)

    Token fine-grained: Resource Access Token: Create en grupo

32. access.token_group_get

    Group Access Token Getsolo lectura

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

    Parámetros obligatorios: group_id (string|integer), token_id (integer)

    Token fine-grained: Resource Access Token: Read en grupo

33. access.token_group_list

    Group Access Token Listsolo lectura

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

    Parámetros obligatorios: group_id (string|integer)

    Token fine-grained: Resource Access Token: Read en grupo

34. access.token_group_revoke

    Group Access Token Revokedestructiva

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

    Parámetros obligatorios: group_id (string|integer), token_id (integer)

    Token fine-grained: Resource Access Token: Delete en grupo

35. access.token_group_rotate

    Group Access Token Rotate

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

    Parámetros obligatorios: group_id (string|integer), token_id (integer)

    Token fine-grained: Resource Access Token: Rotate en grupo

36. access.token_group_rotate_self

    Group 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.

    Parámetros obligatorios: group_id (string|integer)

    Token fine-grained: Resource Access Token: Rotate en grupo

37. access.token_personal_get

    Personal Access Token Getsolo lectura

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

    Parámetros obligatorios: Sin parámetros obligatorios

    Token fine-grained: Personal Access Token: Read en usuario

38. access.token_personal_list

    Personal Access Token Listsolo lectura

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

    Parámetros obligatorios: Sin parámetros obligatorios

    Token fine-grained: Personal Access Token: Read en usuario

39. access.token_personal_revoke

    Personal Access Token Revokedestructiva

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

    Parámetros obligatorios: token_id (integer)

    Token fine-grained: Personal Access Token: Revoke en usuario

40. access.token_personal_revoke_self

    Personal Access Token Revoke Selfdestructiva

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

    Parámetros obligatorios: Sin parámetros obligatorios

    Token fine-grained: Personal Access Token: Revoke en usuario

41. access.token_personal_rotate

    Personal Access Token Rotate

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

    Parámetros obligatorios: token_id (integer)

    Token fine-grained: Personal Access Token: Rotate en usuario

42. access.token_personal_rotate_self

    Personal 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.

    Parámetros obligatorios: Sin parámetros obligatorios

    Token fine-grained: Personal Access Token: Rotate en usuario

43. access.token_project_create

    Project Access Token Create

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

    Parámetros obligatorios: name (string), project_id (string|integer), scopes (array)

    Token fine-grained: Resource Access Token: Create en proyecto

44. access.token_project_get

    Project Access Token Getsolo lectura

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

    Parámetros obligatorios: project_id (string|integer), token_id (integer)

    Token fine-grained: Resource Access Token: Read en proyecto

45. access.token_project_list

    Project Access Token Listsolo lectura

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

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Resource Access Token: Read en proyecto

46. access.token_project_revoke

    Project Access Token Revokedestructiva

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

    Parámetros obligatorios: project_id (string|integer), token_id (integer)

    Token fine-grained: Resource Access Token: Delete en proyecto

47. access.token_project_rotate

    Project Access Token Rotate

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

    Parámetros obligatorios: project_id (string|integer), token_id (integer)

    Token fine-grained: Resource Access Token: Rotate en proyecto

48. access.token_project_rotate_self

    Project 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.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Resource Access Token: Rotate en proyecto