GitHub es la plataforma líder mundial para el desarrollo de software y control de versiones usando Git. Proporciona un entorno colaborativo donde los desarrolladores pueden alojar y revisar código, gestionar proyectos y construir software juntos.
Con GitHub, puedes:
- Alojar repositorios: Almacena tu código en repositorios públicos o privados con control de versiones
- Colaborar en el código: Usa pull requests para proponer cambios, revisar código y fusionar contribuciones
- Seguimiento de problemas: Crea, asigna y gestiona issues para organizar el trabajo y seguir errores
- Automatizar flujos de trabajo: Usa GitHub Actions para construir, probar y desplegar código automáticamente
- Gestionar proyectos: Organiza el trabajo con tableros de proyectos, hitos y seguimiento de tareas
- Documentar código: Crea y mantén documentación con GitHub Pages y wikis
En Sim, la integración con GitHub permite a tus agentes interactuar directamente con repositorios y flujos de trabajo de GitHub. Esto posibilita potentes escenarios de automatización como asistencia en revisión de código, gestión de solicitudes de extracción, seguimiento de problemas y exploración de repositorios. Tus agentes pueden obtener datos del repositorio, analizar cambios en el código, publicar comentarios en solicitudes de extracción y realizar otras operaciones de GitHub de forma programática. Esta integración cierra la brecha entre tus flujos de trabajo de IA y tus procesos de desarrollo, permitiendo una colaboración fluida entre tus agentes y tu equipo de desarrollo.
Integra Github en el flujo de trabajo. Puede obtener detalles de PR, crear comentarios en PR, obtener información del repositorio y obtener el último commit. Requiere una clave API de token de Github. Se puede usar en modo de activación para iniciar un flujo de trabajo cuando se crea un PR, se comenta o se envía un commit.
Obtener detalles de PR incluyendo diferencias y archivos modificados
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
pullNumber | number | Sí | Número de la solicitud de extracción |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen de PR legible para humanos |
metadata | object | Metadatos detallados de PR incluyendo cambios en archivos |
Crear comentarios en PRs de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
body | string | Sí | Contenido del comentario |
pullNumber | number | Sí | Número de la solicitud de extracción |
path | string | No | Ruta del archivo para el comentario de revisión |
position | number | No | Número de línea para el comentario de revisión |
commentType | string | No | Tipo de comentario (pr_comment o file_comment) |
line | number | No | Número de línea para el comentario de revisión |
side | string | No | Lado del diff (LEFT o RIGHT) |
commitId | string | No | El SHA del commit sobre el que comentar |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de comentario legible para humanos |
metadata | object | Metadatos del comentario |
Recupera metadatos completos del repositorio de GitHub, incluyendo estrellas, bifurcaciones, problemas y lenguaje principal. Compatible con repositorios públicos y privados con autenticación opcional.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen del repositorio legible para humanos |
metadata | object | Metadatos del repositorio |
Recupera el último commit de un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
branch | string | No | Nombre de la rama (por defecto, la rama predeterminada del repositorio) |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen del commit legible para humanos |
metadata | object | Metadatos del commit |
Crear un comentario en una incidencia de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
issue_number | number | Sí | Número de la incidencia |
body | string | Sí | Contenido del comentario |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de comentario legible para humanos |
metadata | object | Metadatos del comentario |
Listar todos los comentarios en una incidencia de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
issue_number | number | Sí | Número de la incidencia |
since | string | No | Mostrar solo comentarios actualizados después de esta marca de tiempo ISO 8601 |
per_page | number | No | Número de resultados por página (máximo 100) |
page | number | No | Número de página |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen de comentarios legible para humanos |
metadata | object | Metadatos de la lista de comentarios |
Actualizar un comentario existente en un issue o solicitud de extracción de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
comment_id | number | Sí | ID del comentario |
body | string | Sí | Contenido actualizado del comentario |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de actualización legible para humanos |
metadata | object | Metadatos del comentario actualizado |
Eliminar un comentario en un issue o solicitud de extracción de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
comment_id | number | Sí | ID del comentario |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de eliminación legible para humanos |
metadata | object | Metadatos del resultado de la eliminación |
Listar todos los comentarios de revisión en una solicitud de extracción de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
pullNumber | number | Sí | Número de la solicitud de extracción |
sort | string | No | Ordenar por creación o actualización |
direction | string | No | Dirección de ordenación (asc o desc) |
since | string | No | Mostrar solo comentarios actualizados después de esta marca de tiempo ISO 8601 |
per_page | number | No | Número de resultados por página (máx. 100) |
page | number | No | Número de página |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen de comentarios de revisión legible para humanos |
metadata | object | Metadatos de la lista de comentarios de revisión |
Crear una nueva solicitud de extracción en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
title | string | Sí | Título de la solicitud de extracción |
head | string | Sí | El nombre de la rama donde se implementan tus cambios |
base | string | Sí | El nombre de la rama a la que quieres incorporar los cambios |
body | string | No | Descripción de la solicitud de extracción (Markdown) |
draft | boolean | No | Crear como borrador de solicitud de extracción |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de creación de PR legible para humanos |
metadata | object | Metadatos de la solicitud de extracción |
Actualizar una solicitud de extracción existente en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
pullNumber | number | Sí | Número de la solicitud de extracción |
title | string | No | Nuevo título de la solicitud de extracción |
body | string | No | Nueva descripción de la solicitud de extracción (Markdown) |
state | string | No | Nuevo estado (open o closed) |
base | string | No | Nuevo nombre de la rama base |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de actualización de PR legible para humanos |
metadata | object | Metadatos actualizados de la solicitud de extracción |
Fusionar una solicitud de extracción en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
pullNumber | number | Sí | Número de la solicitud de extracción |
commit_title | string | No | Título para el commit de fusión |
commit_message | string | No | Detalle adicional para añadir al mensaje del commit de fusión |
merge_method | string | No | Método de fusión: merge, squash o rebase |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de fusión legible para humanos |
metadata | object | Metadatos del resultado de la fusión |
Listar solicitudes de extracción en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
state | string | No | Filtrar por estado: open, closed o all |
head | string | No | Filtrar por usuario head o nombre de rama (formato: usuario:nombre-ref o organización:nombre-ref) |
base | string | No | Filtrar por nombre de rama base |
sort | string | No | Ordenar por: created, updated, popularity o long-running |
direction | string | No | Dirección de ordenación: asc o desc |
per_page | number | No | Resultados por página (máx 100) |
page | number | No | Número de página |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Lista de solicitudes de extracción legible para humanos |
metadata | object | Metadatos de la lista de solicitudes de extracción |
Obtener la lista de archivos modificados en una solicitud de extracción
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
pullNumber | number | Sí | Número de la solicitud de extracción |
per_page | number | No | Resultados por página (máximo 100) |
page | number | No | Número de página |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Lista legible para humanos de archivos modificados en la PR |
metadata | object | Metadatos de los archivos de la PR |
Cerrar una solicitud de extracción en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
pullNumber | number | Sí | Número de la solicitud de extracción |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de cierre de PR legible para humanos |
metadata | object | Metadatos de la solicitud de extracción cerrada |
Solicitar revisores para una solicitud de extracción
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
pullNumber | number | Sí | Número de la solicitud de extracción |
reviewers | string | Sí | Lista separada por comas de nombres de usuario a los que solicitar revisiones |
team_reviewers | string | No | Lista separada por comas de slugs de equipos a los que solicitar revisiones |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de solicitud de revisores legible para humanos |
metadata | object | Metadatos de los revisores solicitados |
Obtener el contenido de un archivo de un repositorio de GitHub. Compatible con archivos de hasta 1MB. El contenido se devuelve decodificado y legible para humanos.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
path | string | Sí | Ruta al archivo en el repositorio (p. ej., "src/index.ts") |
ref | string | No | Nombre de la rama, etiqueta o SHA del commit (por defecto, la rama predeterminada del repositorio) |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Información del archivo legible para humanos con vista previa del contenido |
metadata | object | Metadatos del archivo incluyendo nombre, ruta, SHA, tamaño y URLs |
Crear un nuevo archivo en un repositorio de GitHub. El contenido del archivo se codificará automáticamente en Base64. Admite archivos de hasta 1MB.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
path | string | Sí | Ruta donde se creará el archivo (p. ej., "src/nuevoarchivo.ts") |
message | string | Sí | Mensaje del commit para esta creación de archivo |
content | string | Sí | Contenido del archivo (texto plano, se codificará automáticamente en Base64) |
branch | string | No | Rama en la que crear el archivo (por defecto, la rama predeterminada del repositorio) |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de creación de archivo legible para humanos |
metadata | object | Metadatos del archivo y del commit |
Actualizar un archivo existente en un repositorio de GitHub. Requiere el SHA del archivo. El contenido se codificará automáticamente en Base64. Admite archivos de hasta 1MB.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
path | string | Sí | Ruta al archivo a actualizar (p. ej., "src/index.ts") |
message | string | Sí | Mensaje de commit para esta actualización de archivo |
content | string | Sí | Nuevo contenido del archivo (texto plano, será codificado en Base64 automáticamente) |
sha | string | Sí | El SHA del blob del archivo que se está reemplazando (obtener de github_get_file_content) |
branch | string | No | Rama en la que actualizar el archivo (por defecto, la rama predeterminada del repositorio) |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de actualización de archivo legible para humanos |
metadata | object | Metadatos del archivo actualizado y del commit |
Elimina un archivo de un repositorio de GitHub. Requiere el SHA del archivo. Esta operación no se puede deshacer a través de la API.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
path | string | Sí | Ruta al archivo a eliminar (p. ej., "src/oldfile.ts") |
message | string | Sí | Mensaje de commit para esta eliminación de archivo |
sha | string | Sí | El SHA del blob del archivo que se está eliminando (obtener de github_get_file_content) |
branch | string | No | Rama de la que eliminar el archivo (por defecto, la rama predeterminada del repositorio) |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de eliminación de archivo legible para humanos |
metadata | object | Confirmación de eliminación y metadatos del commit |
Obtiene el contenido de un directorio en un repositorio de GitHub. Devuelve una lista de archivos y subdirectorios. Usa una ruta vacía u omítela para obtener el contenido del directorio raíz.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
path | string | No | Ruta del directorio (p. ej., "src/components"). Dejar vacío para el directorio raíz. |
ref | string | No | Nombre de la rama, etiqueta o SHA del commit (por defecto, la rama predeterminada del repositorio) |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Listado del árbol de directorios legible para humanos |
metadata | object | Metadatos del contenido del directorio |
Lista todas las ramas en un repositorio de GitHub. Opcionalmente filtra por estado de protección y controla la paginación.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
protected | boolean | No | Filtrar ramas por estado de protección |
per_page | number | No | Número de resultados por página (máx. 100, predeterminado 30) |
page | number | No | Número de página para paginación (predeterminado 1) |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Lista de ramas legible para humanos |
metadata | object | Metadatos de la lista de ramas |
Obtener información detallada sobre una rama específica en un repositorio de GitHub, incluyendo detalles del commit y estado de protección.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
branch | string | Sí | Nombre de la rama |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Detalles de la rama legibles para humanos |
metadata | object | Metadatos de la rama |
Crear una nueva rama en un repositorio de GitHub mediante la creación de una referencia git que apunte a un SHA de commit específico.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
branch | string | Sí | Nombre de la rama a crear |
sha | string | Sí | SHA del commit al que apuntará la rama |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de creación de rama legible para humanos |
metadata | object | Metadatos de referencia Git |
Elimina una rama de un repositorio GitHub eliminando su referencia git. Las ramas protegidas no pueden ser eliminadas.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
branch | string | Sí | Nombre de la rama a eliminar |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de eliminación legible para humanos |
metadata | object | Metadatos de eliminación |
Obtiene las reglas de protección de una rama específica, incluyendo verificaciones de estado, requisitos de revisión y restricciones.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
branch | string | Sí | Nombre de la rama |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen de protección de rama legible para humanos |
metadata | object | Configuración de protección de rama |
Actualiza las reglas de protección de rama para una rama específica, incluyendo verificaciones de estado, requisitos de revisión, aplicación para administradores y restricciones de push.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
branch | string | Sí | Nombre de la rama |
required_status_checks | object | Sí | Configuración de verificación de estado requerida (null para desactivar). Objeto con strict (booleano) y contexts (array de strings) |
enforce_admins | boolean | Sí | Si se deben aplicar restricciones para administradores |
required_pull_request_reviews | object | Sí | Requisitos de revisión de PR (null para desactivar). Objeto con opcionales required_approving_review_count, dismiss_stale_reviews, require_code_owner_reviews |
restrictions | object | Sí | Restricciones de push (null para desactivar). Objeto con users (array de strings) y teams (array de strings) |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen legible para humanos de la actualización de protección de rama |
metadata | object | Configuración actualizada de protección de rama |
Crear un nuevo issue en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
title | string | Sí | Título del issue |
body | string | No | Descripción/cuerpo del issue |
assignees | string | No | Lista separada por comas de nombres de usuario para asignar a este issue |
labels | string | No | Lista separada por comas de nombres de etiquetas para añadir a este issue |
milestone | number | No | Número de hito para asociar con este issue |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de creación de issue legible para humanos |
metadata | object | Metadatos del issue |
Actualizar un issue existente en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
issue_number | number | Sí | Número del issue |
title | string | No | Nuevo título del issue |
body | string | No | Nueva descripción/cuerpo del issue |
state | string | No | Estado del issue (open o closed) |
labels | array | No | Array de nombres de etiquetas (reemplaza todas las etiquetas existentes) |
assignees | array | No | Array de nombres de usuario (reemplaza todos los asignados existentes) |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de actualización de issue legible para humanos |
metadata | object | Metadatos del issue actualizado |
Listar issues en un repositorio de GitHub. Nota: Esto incluye pull requests ya que los PR son considerados issues en GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
state | string | No | Filtrar por estado: open, closed, o all (predeterminado: open) |
assignee | string | No | Filtrar por nombre de usuario asignado |
creator | string | No | Filtrar por nombre de usuario del creador |
labels | string | No | Lista separada por comas de nombres de etiquetas para filtrar |
sort | string | No | Ordenar por: created, updated, o comments (predeterminado: created) |
direction | string | No | Dirección de ordenamiento: asc o desc (predeterminado: desc) |
per_page | number | No | Resultados por página (máximo 100, predeterminado: 30) |
page | number | No | Número de página (predeterminado: 1) |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Lista de issues legible para humanos |
metadata | object | Metadatos de la lista de issues |
Obtener información detallada sobre un issue específico en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
issue_number | number | Sí | Número del issue |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Detalles del issue legibles para humanos |
metadata | object | Metadatos detallados del issue |
Cerrar un issue en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
issue_number | number | Sí | Número del issue |
state_reason | string | No | Razón para cerrar: completed o not_planned |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de cierre del issue legible para humanos |
metadata | object | Metadatos del issue cerrado |
Añadir etiquetas a un issue en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
issue_number | number | Sí | Número del issue |
labels | string | Sí | Lista separada por comas de nombres de etiquetas para añadir al issue |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de etiquetas legible para humanos |
metadata | object | Metadatos de las etiquetas |
Eliminar una etiqueta de un issue en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
issue_number | number | Sí | Número del issue |
name | string | Sí | Nombre de la etiqueta a eliminar |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de eliminación de etiqueta legible para humanos |
metadata | object | Metadatos de las etiquetas restantes |
Añadir asignados a un issue en un repositorio de GitHub
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio |
repo | string | Sí | Nombre del repositorio |
issue_number | number | Sí | Número de incidencia |
assignees | string | Sí | Lista de nombres de usuario separados por comas para asignar a la incidencia |
apiKey | string | Sí | Token de API de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de asignaciones legible para humanos |
metadata | object | Metadatos actualizados de la incidencia con los asignados |
Crear una nueva versión para un repositorio de GitHub. Especifica el nombre de la etiqueta, el commit objetivo, el título, la descripción y si debe ser un borrador o una versión preliminar.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
tag_name | string | Sí | El nombre de la etiqueta para esta versión |
target_commitish | string | No | Especifica el valor commitish que determina desde dónde se crea la etiqueta Git. Puede ser cualquier rama o SHA de commit. Por defecto es la rama predeterminada del repositorio. |
name | string | No | El nombre de la versión |
body | string | No | Texto que describe el contenido de la versión (admite markdown) |
draft | boolean | No | true para crear una versión en borrador (no publicada), false para crear una publicada |
prerelease | boolean | No | true para identificar la versión como preliminar, false para identificarla como versión completa |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen de creación de versión legible para humanos |
metadata | object | Metadatos de la versión incluyendo URLs de descarga |
Actualiza una versión existente de GitHub. Modifica el nombre de la etiqueta, el commit objetivo, el título, la descripción, el estado de borrador o el estado de prelanzamiento.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
release_id | number | Sí | El identificador único de la versión |
tag_name | string | No | El nombre de la etiqueta |
target_commitish | string | No | Especifica el valor commitish desde donde se crea la etiqueta |
name | string | No | El nombre de la versión |
body | string | No | Texto que describe el contenido de la versión (admite markdown) |
draft | boolean | No | true para establecer como borrador, false para publicar |
prerelease | boolean | No | true para identificar como prelanzamiento, false para una versión completa |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen de actualización de versión legible para humanos |
metadata | object | Metadatos actualizados de la versión incluyendo URLs de descarga |
Lista todas las versiones de un repositorio de GitHub. Devuelve información de las versiones incluyendo etiquetas, nombres y URLs de descarga.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
per_page | number | No | Número de resultados por página (máximo 100) |
page | number | No | Número de página de los resultados a obtener |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Lista legible para humanos de versiones con resumen |
metadata | object | Metadatos de las versiones |
Obtiene información detallada sobre una versión específica de GitHub por ID. Devuelve metadatos de la versión incluyendo activos y URLs de descarga.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
release_id | number | Sí | El identificador único de la versión |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Detalles de la versión legibles para humanos |
metadata | object | Metadatos de la versión incluyendo URLs de descarga |
Elimina una versión de GitHub por ID. Esto elimina permanentemente la versión pero no borra la etiqueta Git asociada.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
release_id | number | Sí | El identificador único de la versión a eliminar |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Confirmación de eliminación legible para humanos |
metadata | object | Metadatos del resultado de la eliminación |
Lista todos los flujos de trabajo en un repositorio de GitHub. Devuelve detalles del flujo de trabajo incluyendo ID, nombre, ruta, estado y URL de la insignia.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
per_page | number | No | Número de resultados por página (predeterminado: 30, máximo: 100) |
page | number | No | Número de página de resultados a obtener (predeterminado: 1) |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen de flujos de trabajo legible para humanos |
metadata | object | Metadatos de flujos de trabajo |
Obtén detalles de un flujo de trabajo específico de GitHub Actions por ID o nombre de archivo. Devuelve información del flujo de trabajo incluyendo nombre, ruta, estado y URL de la insignia.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
workflow_id | string | Sí | ID del flujo de trabajo (número) o nombre del archivo del flujo de trabajo (p. ej., "main.yaml") |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Detalles del flujo de trabajo legibles para humanos |
metadata | object | Metadatos del flujo de trabajo |
Activa un evento de dispatch para un flujo de trabajo de GitHub Actions. El flujo de trabajo debe tener configurado un disparador workflow_dispatch. Devuelve 204 No Content en caso de éxito.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
workflow_id | string | Sí | ID del flujo de trabajo (número) o nombre del archivo del flujo de trabajo (p. ej., "main.yaml") |
ref | string | Sí | Referencia Git (rama o nombre de etiqueta) donde ejecutar el flujo de trabajo |
inputs | object | No | Claves de entrada y valores configurados en el archivo del flujo de trabajo |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de confirmación |
metadata | object | Objeto de metadatos vacío (respuesta 204 Sin Contenido) |
Lista las ejecuciones de flujos de trabajo para un repositorio. Admite filtrado por actor, rama, evento y estado. Devuelve detalles de la ejecución incluyendo estado, conclusión y enlaces.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
actor | string | No | Filtrar por usuario que activó el flujo de trabajo |
branch | string | No | Filtrar por nombre de rama |
event | string | No | Filtrar por tipo de evento (p. ej., push, pull_request, workflow_dispatch) |
status | string | No | Filtrar por estado (queued, in_progress, completed, waiting, requested, pending) |
per_page | number | No | Número de resultados por página (predeterminado: 30, máximo: 100) |
page | number | No | Número de página de resultados a obtener (predeterminado: 1) |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen de ejecuciones de flujo de trabajo legible para humanos |
metadata | object | Metadatos de ejecuciones de flujo de trabajo |
Obtiene información detallada sobre una ejecución específica de flujo de trabajo por ID. Devuelve estado, conclusión, tiempos y enlaces a la ejecución.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
run_id | number | Sí | ID de la ejecución del flujo de trabajo |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Detalles de la ejecución del flujo de trabajo legibles para humanos |
metadata | object | Metadatos de la ejecución del flujo de trabajo |
Cancela una ejecución de flujo de trabajo. Devuelve 202 Accepted si se inicia la cancelación, o 409 Conflict si la ejecución no puede ser cancelada (ya completada).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
run_id | number | Sí | ID de la ejecución del flujo de trabajo a cancelar |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de estado de cancelación |
metadata | object | Metadatos de cancelación |
Vuelve a ejecutar un flujo de trabajo. Opcionalmente habilita el registro de depuración para la nueva ejecución. Devuelve 201 Created en caso de éxito.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner | string | Sí | Propietario del repositorio (usuario u organización) |
repo | string | Sí | Nombre del repositorio |
run_id | number | Sí | ID de la ejecución del flujo de trabajo a volver a ejecutar |
enable_debug_logging | boolean | No | Habilitar registro de depuración para la nueva ejecución (predeterminado: false) |
apiKey | string | Sí | Token de acceso personal de GitHub |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de confirmación de reejecución |
metadata | object | Metadatos de la reejecución |
Lista los Proyectos V2 de GitHub para una organización o usuario. Devuelve hasta 20 proyectos con sus detalles, incluyendo ID, título, número, URL y estado.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner_type | string | Sí | Tipo de propietario: "org" para organización o "user" para usuario |
owner_login | string | Sí | Nombre de inicio de sesión de la organización o usuario |
apiKey | string | Sí | Token de acceso personal de GitHub con permisos de lectura de proyectos |
| Parámetro | Tipo | Descripción |
|---|
content | string | Lista de proyectos legible para humanos |
metadata | object | Metadatos de los proyectos |
Obtiene información detallada sobre un Proyecto V2 específico de GitHub por su número. Devuelve detalles del proyecto incluyendo ID, título, descripción, URL y estado.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner_type | string | Sí | Tipo de propietario: "org" para organización o "user" para usuario |
owner_login | string | Sí | Nombre de inicio de sesión de la organización o usuario |
project_number | number | Sí | Número del proyecto |
apiKey | string | Sí | Token de acceso personal de GitHub con permisos de lectura de proyectos |
| Parámetro | Tipo | Descripción |
|---|
content | string | Detalles del proyecto legibles para humanos |
metadata | object | Metadatos del proyecto |
Crea un nuevo Proyecto GitHub V2. Requiere el ID de nodo del propietario (no el nombre de inicio de sesión). Devuelve el proyecto creado con ID, título y URL.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
owner_id | string | Sí | ID de nodo del propietario (formato: PVT_... o MDQ6...). Usa la API GraphQL de GitHub para obtener este ID a partir del inicio de sesión de la organización o usuario. |
title | string | Sí | Título del proyecto |
apiKey | string | Sí | Token de acceso personal de GitHub con permisos de escritura para proyectos |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de confirmación legible para humanos |
metadata | object | Metadatos del proyecto creado |
Actualiza un Proyecto GitHub V2 existente. Puede actualizar el título, la descripción, la visibilidad (pública) o el estado (cerrado). Requiere el ID de nodo del proyecto.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
project_id | string | Sí | ID de nodo del proyecto (formato: PVT_...) |
title | string | No | Nuevo título del proyecto |
shortDescription | string | No | Nueva descripción breve del proyecto |
project_public | boolean | No | Establecer visibilidad del proyecto (true = público, false = privado) |
closed | boolean | No | Establecer estado del proyecto (true = cerrado, false = abierto) |
apiKey | string | Sí | Token de acceso personal de GitHub con permisos de escritura para proyectos |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de confirmación legible para humanos |
metadata | object | Metadatos actualizados del proyecto |
Elimina un Proyecto GitHub V2. Esta acción es permanente y no se puede deshacer. Requiere el ID de nodo del proyecto.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
project_id | string | Sí | ID de nodo del proyecto (formato: PVT_...) |
apiKey | string | Sí | Token de acceso personal de GitHub con permisos de administrador de proyecto |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de confirmación legible para humanos |
metadata | object | Metadatos del proyecto eliminado |
- Categoría:
tools
- Tipo:
github
