Skip to main content
PUT
Indexer des repositories en masse

Autorisations

Nécessite un utilisateur de service ou un jeton d’accès personnel. La vérification des autorisations dépend de la façon dont l’accès aux repositories est géré dans votre organisation :
  • Autorisations au niveau de l’organisation : l’appelant doit disposer de l’autorisation IndexOrgRepositories au niveau de l’organisation.
  • Autorisations granulaires par repository : l’autorisation IndexOrgRepositories n’est pas vérifiée. L’appelant doit disposer de l’autorisation Read au niveau de l’organisation, ainsi que des deux autorisations repo.use_read et repo.index sur chacun des repositories de la requête. S’il manque l’une ou l’autre de ces autorisations sur un seul repository, l’ensemble de la requête est rejeté avec une erreur 403 et aucun repository n’est indexé.

Comportement

Cet endpoint est idempotent — l’appeler plusieurs fois avec les mêmes dépôts ne créera pas de tâches d’indexation en double. Il active l’indexation et déclenche une tâche d’indexation pour chaque dépôt de la requête. Vous pouvez également spécifier branch_names pour chaque dépôt afin d’indexer des branches spécifiques. Si cette valeur est omise, la branche par défaut est utilisée.

Autorisations

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

org_id
string
requis

Identifiant d’organisation (préfixe : org-)

Exemple:

"org-abc123def456"

Corps

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

Réponse

Réponse réussie

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