Skip to main content
PUT
Indexar un repositorio

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 los 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 sobre el repositorio. De lo contrario, la solicitud se rechaza con un error 403.

Comportamiento

Este endpoint es idempotente: llamarlo varias veces para el mismo repositorio no creará trabajos de indexación duplicados. Habilita la indexación y desencadena trabajos de indexación para el repositorio especificado. Opcionalmente, puedes especificar branch_names en el cuerpo de la solicitud para 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

repository_path
string
requerido
org_id
string
requerido

ID de organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

Cuerpo

application/json
branch_names
string[]

Respuesta

Respuesta satisfactoria

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