> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Indexar repositorios en bloque
> Habilita de forma idempotente la indexación para un conjunto de repositorios y activa jobs de indexación.
Permisos
Requiere un [usuario de servicio](/es/api-reference/v3/service-users/members-service-users) o un [token de acceso personal](/es/api-reference/personal-access-tokens). 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.
## OpenAPI
````yaml es/v3-openapi.yaml PUT /v3beta1/organizations/{org_id}/repositories/indexing
openapi: 3.1.0
info:
description: API de Devin v3 con autenticación mediante usuario de servicio y RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3beta1/organizations/{org_id}/repositories/indexing:
put:
tags:
- repositories
summary: Indexar repositorios en bloque
description: >-
Habilita de forma idempotente la indexación para un conjunto de
repositorios y activa jobs de indexación.
operationId: >-
handle_bulk_index_repositories_v3beta1_organizations__org_id__repositories_indexing_put
parameters:
- description: 'ID de la organización (prefijo: org-)'
in: path
name: org_id
required: true
schema:
example: org-abc123def456
title: Org Id
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BulkIndexRepositoriesRequest'
required: true
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/RepositoryIndexingResponse'
title: >-
Response Handle Bulk Index Repositories V3Beta1 Organizations
Org Id Repositories Indexing Put
type: array
description: Respuesta exitosa
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: No autorizado
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Prohibido
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: No encontrado
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflicto
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenido no procesable
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Demasiadas solicitudes
components:
schemas:
BulkIndexRepositoriesRequest:
properties:
repositories:
items:
$ref: '#/components/schemas/RepositoryIndexingItem'
maxItems: 100
minItems: 1
title: Repositories
type: array
required:
- repositories
title: BulkIndexRepositoriesRequest
type: object
RepositoryIndexingResponse:
properties:
branches:
items:
type: string
title: Branches
type: array
indexing_enabled:
title: Indexing Enabled
type: boolean
indexing_status:
anyOf:
- $ref: '#/components/schemas/RepoIndexingStatusResponse'
- type: 'null'
repository_path:
title: Repository Path
type: string
required:
- repository_path
- indexing_enabled
- branches
title: RepositoryIndexingResponse
type: object
ProblemDetail:
description: >-
Cuerpo de error RFC 9457 application/problem+json para la API v3.
detail se conserva del cuerpo heredado {"detail": ...} por
compatibilidad con versiones anteriores; los
otros miembros son adicionales. errors contiene errores de validación
a nivel de campo (solo 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Explicación legible para humanos específica de esta ocurrencia.
title: Detail
error_code:
anyOf:
- type: string
- type: 'null'
description: >-
Código legible por máquina que indica el rechazo de una acción
bloqueada (p. ej., "user_frozen", "migrated_session").
title: Error Code
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Errores de validación por campo (solo en respuestas 422).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Una referencia URI (la ruta de la solicitud) para esta ocurrencia.
title: Instance
status:
description: El código de estado HTTP.
title: Status
type: integer
title:
description: Un breve resumen del tipo de problema, legible para humanos.
title: Title
type: string
type:
default: about:blank
description: Una referencia URI que identifica el tipo de problema.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
RepositoryIndexingItem:
properties:
branch_names:
items:
type: string
title: Branch Names
type: array
repository_path:
description: p. ej., 'org/repo-name'
title: Repository Path
type: string
required:
- repository_path
title: RepositoryIndexingItem
type: object
RepoIndexingStatusResponse:
properties:
indexing_enabled:
title: Indexing Enabled
type: boolean
latest_completed_search_index_job:
anyOf:
- $ref: '#/components/schemas/RepoIndexJobResponse'
- type: 'null'
latest_completed_wiki_index_job:
anyOf:
- $ref: '#/components/schemas/RepoIndexJobResponse'
- type: 'null'
latest_indexes:
items:
$ref: '#/components/schemas/RepoIndexJobResponse'
title: Latest Indexes
type: array
required:
- indexing_enabled
- latest_indexes
- latest_completed_search_index_job
- latest_completed_wiki_index_job
title: RepoIndexingStatusResponse
type: object
RepoIndexJobResponse:
properties:
branch_name:
anyOf:
- type: string
- type: 'null'
title: Branch Name
commit:
title: Commit
type: string
created_at:
title: Created At
type: integer
job_id:
title: Job Id
type: string
status:
enum:
- failed
- completed
- in_progress
title: Status
type: string
required:
- job_id
- status
- commit
- branch_name
- created_at
title: RepoIndexJobResponse
type: object
securitySchemes:
bearerAuth:
description: 'Credencial de usuario de servicio (prefijo: cog_)'
scheme: bearer
type: http
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.