Dominio de acciones

snippet

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.

34 · acciones6 · destructivas17 · 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. snippet.content

   Snippet Contentsolo lectura

   Read a personal snippet's raw content. Returns: the snippet ID and raw text content. See also: snippet.get, snippet.file_content.

   Parámetros obligatorios: snippet_id (integer)

   Token fine-grained: Snippet: Read en usuario

2. snippet.create

   Snippet Create

   Create a personal snippet. Returns: the created snippet with ID, visibility, author, files, and web URL. See also: snippet.get, snippet.update, snippet.list.

   Parámetros obligatorios: title (string)

   Al menos uno de: file_name (string) + content (string) o files (array)

   Token fine-grained: Snippet: Create en usuario

3. snippet.delete

   Snippet Deletedestructiva

   Delete a personal snippet permanently. Returns: a success confirmation. See also: snippet.get, snippet.list.

   Parámetros obligatorios: snippet_id (integer)

   Token fine-grained: Snippet: Delete en usuario

4. snippet.discussion_add_note

   Add Snippet Discussion Note

   Add a reply note to an existing snippet discussion thread. Returns: the created note (author, body, timestamps). See also: snippet.discussion_create, snippet.discussion_get, snippet.discussion_update_note.

   Parámetros obligatorios: body (string), discussion_id (string), project_id (string|integer), snippet_id (integer)

   Token fine-grained: Work Item: Create en proyecto

5. snippet.discussion_create

   Create Snippet Discussion

   Create a new discussion thread on a project snippet with an initial note. Returns: the created thread with its first note. See also: snippet.discussion_add_note, snippet.discussion_list, snippet.note_create.

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

   Token fine-grained: Work Item: Create en proyecto

6. snippet.discussion_delete_note

   Delete Snippet Discussion Notedestructiva

   Delete a note from a snippet discussion thread (destructive). Returns: a deletion confirmation message. See also: snippet.discussion_update_note, snippet.discussion_get, snippet.discussion_list.

   Parámetros obligatorios: discussion_id (string), note_id (integer), project_id (string|integer), snippet_id (integer)

   Token fine-grained: Work Item: Delete en proyecto

7. snippet.discussion_get

   Get Snippet Discussionsolo lectura

   Get a single snippet discussion thread by its discussion id. Returns: the thread with every note (author, body, system flag, resolvable/resolved state). See also: snippet.discussion_list, snippet.discussion_add_note, snippet.project_get.

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

   Token fine-grained: Work Item: Read en proyecto

8. snippet.discussion_list

   List Snippet Discussionssolo lectura

   List discussion threads on a project snippet with ordering and keyset pagination. Returns: discussion threads with their notes (author, body, system flag, resolvable state) and pagination metadata. See also: snippet.discussion_get, snippet.discussion_create, snippet.project_get, snippet.note_list.

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

   Token fine-grained: Work Item: Read en proyecto

9. snippet.discussion_update_note

   Update Snippet Discussion Note

   Update the body of a note in a snippet discussion thread. Returns: the updated note. See also: snippet.discussion_add_note, snippet.discussion_delete_note, snippet.discussion_get.

   Parámetros obligatorios: body (string), discussion_id (string), note_id (integer), project_id (string|integer), snippet_id (integer)

   Token fine-grained: Work Item: Update en proyecto

10. snippet.emoji_snippet_create

    Snippet Emoji Create

    Add an emoji reaction to a project snippet. Returns: the created award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: snippet.emoji_snippet_list, snippet.emoji_snippet_delete.

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

    Token fine-grained: Work Item: Create en proyecto

11. snippet.emoji_snippet_delete

    Snippet Emoji Deletedestructiva

    Remove an emoji reaction from a project snippet by award id. Returns: a success confirmation naming the award emoji. See also: snippet.emoji_snippet_list, snippet.emoji_snippet_get.

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

    Token fine-grained: Work Item: Delete en proyecto

12. snippet.emoji_snippet_get

    Snippet Emoji Getsolo lectura

    Get a single emoji reaction on a project snippet by award id. Returns: the award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: snippet.emoji_snippet_list, snippet.emoji_snippet_delete.

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

    Token fine-grained: Work Item: Read en proyecto

13. snippet.emoji_snippet_list

    Snippet Emoji Listsolo lectura

    List all emoji reactions on a project snippet. Returns: each award with its emoji name, the awarding user object, awardable id/type, and pagination metadata. See also: snippet.emoji_snippet_get, snippet.emoji_snippet_create, snippet.project_get.

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

    Token fine-grained: Work Item: Read en proyecto

14. snippet.emoji_snippet_note_create

    Snippet Note Emoji Create

    Add an emoji reaction to a project snippet note. Returns: the created award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: snippet.emoji_snippet_note_list, snippet.emoji_snippet_note_delete.

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

    Token fine-grained: Work Item: Create en proyecto

15. snippet.emoji_snippet_note_delete

    Snippet Note Emoji Deletedestructiva

    Remove an emoji reaction from a project snippet note by award id. Returns: a success confirmation naming the award emoji. See also: snippet.emoji_snippet_note_list, snippet.emoji_snippet_note_get.

    Parámetros obligatorios: award_id (integer), note_id (integer), project_id (string|integer), snippet_id (integer)

    Token fine-grained: Work Item: Delete en proyecto

16. snippet.emoji_snippet_note_get

    Snippet Note Emoji Getsolo lectura

    Get a single emoji reaction on a project snippet note by award id. Returns: the award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: snippet.emoji_snippet_note_list, snippet.emoji_snippet_note_delete.

    Parámetros obligatorios: award_id (integer), note_id (integer), project_id (string|integer), snippet_id (integer)

    Token fine-grained: Work Item: Read en proyecto

17. snippet.emoji_snippet_note_list

    Snippet Note Emoji Listsolo lectura

    List all emoji reactions on a project snippet note (comment). Returns: each award with its emoji name, the awarding user object, awardable id/type, and pagination metadata. See also: snippet.emoji_snippet_note_get, snippet.emoji_snippet_note_create, snippet.note_get.

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

    Token fine-grained: Work Item: Read en proyecto

18. snippet.explore

    Snippet Exploresolo lectura

    List public snippets across the instance. Returns: public snippets with author, visibility, and pagination metadata. See also: snippet.list, snippet.get.

    Parámetros obligatorios: Sin parámetros obligatorios

    Token fine-grained: Snippet: Read en usuario

19. snippet.file_content

    Snippet File Contentsolo lectura

    Read one file from a multi-file personal snippet at a ref. Returns: the snippet ID, ref, file name, and raw content. See also: snippet.content, snippet.get.

    Parámetros obligatorios: file_name (string), ref (string), snippet_id (integer)

    Token fine-grained: Snippet: Read en usuario

20. snippet.get

    Snippet Getsolo lectura

    Get a single personal snippet by ID. Returns: snippet metadata, visibility, author, files, and web URL. See also: snippet.list, snippet.content, snippet.update, snippet.delete.

    Parámetros obligatorios: snippet_id (integer)

    Token fine-grained: Snippet: Read en usuario

21. snippet.list

    Snippet Listsolo lectura

    List snippets owned by the authenticated user. Returns: snippets with title, visibility, author, files, and pagination metadata. See also: snippet.get, snippet.create, snippet.explore.

    Parámetros obligatorios: Sin parámetros obligatorios

    Token fine-grained: Snippet: Read en usuario

22. snippet.list_all

    Snippet List Allsolo lectura

    List all snippets on the instance (admin). Returns: snippets with author, visibility, repository storage, and pagination metadata. See also: snippet.list, snippet.explore, snippet.get.

    Parámetros obligatorios: Sin parámetros obligatorios

    Token fine-grained: Snippet: Read en usuario

23. snippet.note_create

    Snippet Note Create

    Add a comment (note) to a project snippet. Returns: the created note with id, author, body, and timestamps. See also: snippet.note_list, snippet.note_get, snippet.project_get.

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

    Token fine-grained: Work Item: Create en proyecto

24. snippet.note_delete

    Snippet Note Deletedestructiva

    Delete a snippet note permanently. Returns: a success confirmation naming the note, snippet, and project. See also: snippet.note_get, snippet.note_list.

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

    Token fine-grained: Work Item: Delete en proyecto

25. snippet.note_get

    Snippet Note Getsolo lectura

    Get a single snippet note by its ID. Returns: the note with author, body, timestamps, and position. See also: snippet.note_list, snippet.note_update, snippet.note_delete.

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

    Token fine-grained: Work Item: Read en proyecto

26. snippet.note_list

    Snippet Note Listsolo lectura

    List all notes (comments) on a project snippet. Returns: notes with author, body, system flag, and pagination metadata. See also: snippet.note_get, snippet.note_create, snippet.project_get.

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

    Token fine-grained: Work Item: Read en proyecto

27. snippet.note_update

    Snippet Note Update

    Update a snippet note's body. Returns: the updated note with new body and updated_at timestamp. See also: snippet.note_get, snippet.note_list, snippet.note_delete.

    Parámetros obligatorios: body (string), note_id (integer), project_id (string|integer), snippet_id (integer)

    Token fine-grained: Work Item: Update en proyecto

28. snippet.project_content

    Project Snippet Contentsolo lectura

    Read a project snippet's raw content. Returns: the snippet ID and raw text content. See also: snippet.project_get, snippet.project_list.

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

    Token fine-grained: Snippet: Read en proyecto

29. snippet.project_create

    Project Snippet Create

    Create a project snippet. Returns: the created snippet with ID, visibility, author, files, and web URL. See also: snippet.project_get, snippet.project_update, snippet.project_list.

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

    Al menos uno de: file_name (string) + content (string) o files (array)

    Token fine-grained: Snippet: Create en proyecto

30. snippet.project_delete

    Project Snippet Deletedestructiva

    Delete a project snippet permanently. Returns: a success confirmation. See also: snippet.project_get, snippet.project_list.

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

    Token fine-grained: Snippet: Delete en proyecto

31. snippet.project_get

    Project Snippet Getsolo lectura

    Get a single project snippet. Returns: snippet metadata, visibility, author, files, and web URL. See also: snippet.project_list, snippet.project_content, snippet.project_update, snippet.project_delete.

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

    Token fine-grained: Snippet: Read en proyecto

32. snippet.project_list

    Project Snippet Listsolo lectura

    List a project's snippets. Returns: snippets with title, visibility, author, files, and pagination metadata. See also: snippet.project_get, snippet.project_create, snippet.list.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Snippet: Read en proyecto

33. snippet.project_update

    Project Snippet Update

    Update a project snippet. Returns: the updated snippet with metadata, files, and web URL. See also: snippet.project_get, snippet.project_delete, snippet.project_list.

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

    Token fine-grained: Snippet: Update en proyecto

34. snippet.update

    Snippet Update

    Update a personal snippet. Returns: the updated snippet with metadata, files, and web URL. See also: snippet.get, snippet.delete, snippet.list.

    Parámetros obligatorios: snippet_id (integer)

    Token fine-grained: Snippet: Update en usuario