Skip to main content
PUT
Indexar repositorios en bloque

Permisos

Requiere un usuario de servicio o un token de acceso personal. La comprobación de permisos depende de cómo se gestione el acceso a repositorios en tu organización:
  • Permisos a nivel de organización: quien realiza la llamada necesita el permiso IndexOrgRepositories a nivel de organización.
  • Permisos granulares por repositorio: no se comprueba IndexOrgRepositories. Quien realiza la llamada necesita el permiso Read a nivel de organización y, además, los permisos repo.use_read y repo.index en cada uno de los repositorios incluidos en la solicitud. Si a algún repositorio le falta alguno de estos dos permisos, se rechaza toda la solicitud con un 403 y no se indexa ningún repositorio.

Comportamiento

Este endpoint es idempotente: llamarlo múltiples veces con los mismos repositorios no creará trabajos de indexación duplicados. Habilita la indexación e inicia trabajos de indexación para cada repositorio de la solicitud. Opcionalmente, puedes especificar branch_names para cada repositorio a fin de indexar ramas específicas. Si se omite, se usa la rama predeterminada.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

org_id
string
requerido

ID de organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

Cuerpo

application/json
repositories
RepositoryIndexingItem · object[]
requerido
Required array length: 1 - 100 elements

Respuesta

Respuesta satisfactoria

branches
string[]
requerido
indexing_enabled
boolean
requerido
repository_path
string
requerido
indexing_status
RepoIndexingStatusResponse · object | null