Skip to main content
PUT
Criar índices de repositórios em massa

Permissões

Requer um usuário de serviço ou um token de acesso pessoal. A verificação de permissão depende de como o acesso aos repositórios é gerenciado na sua organização:
  • Permissões no nível da organização: quem faz a chamada precisa da permissão IndexOrgRepositories no nível da organização.
  • Concessões granulares por repositório: a permissão IndexOrgRepositories não é verificada. Quem faz a chamada precisa da permissão Read no nível da organização, além das concessões repo.use_read e repo.index em todos os repositórios da requisição. Se faltar qualquer uma dessas concessões em algum repositório, a requisição inteira será rejeitada com 403 e nenhum repositório será indexado.

Comportamento

Este endpoint é idempotente — chamá-lo várias vezes com os mesmos repositórios não criará trabalhos de indexação duplicados. Ele ativa a indexação e aciona trabalhos de indexação para cada repositório da requisição. Opcionalmente, você pode especificar branch_names para cada repositório a fim de indexar branches específicas. Se for omitido, a branch padrão será usada.

Autorizações

Authorization
string
header
obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de caminho

org_id
string
obrigatório

ID da organização (prefixo: org-)

Exemplo:

"org-abc123def456"

Corpo

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

Resposta

Resposta Bem-Sucedida

branches
string[]
obrigatório
indexing_enabled
boolean
obrigatório
repository_path
string
obrigatório
indexing_status
RepoIndexingStatusResponse · object | null