Skip to main content
POST
Crear un blueprint de nivel org o repo

Permisos

Se requiere un usuario de servicio con el permiso ManageRepoBlueprints a nivel de organización. La creación de blueprints de nivel de organización requiere el permiso ManageOrgSnapshots.

Comportamiento

Crea un blueprint de nivel de organización o de repo. Un blueprint define la configuración declarativa de Environment para las sesiones de Devin. Modificar un blueprint no activa automáticamente una compilación; debes llamar explícitamente al endpoint de compilaciones.
Los blueprints no existen de forma independiente de tu configuración de Environment. Crear un blueprint con un repo_name también agrega ese repositorio al Environment; no existe un endpoint independiente para registrar primero el repo. El repositorio se clona en el Environment en la siguiente compilación y se inicia su indexación.También ocurre lo contrario: eliminar un repositorio del Environment (el interruptor Incluir en Environment en la UI) elimina todos los blueprints de ese repo, incluidos todos sus ámbitos de workspace.
El nombre del repositorio debe ser uno al que Devin ya pueda acceder mediante tu integración de Git (por ejemplo, owner/repo); un repo desconocido o inaccesible devuelve 404 y no se crea ningún blueprint. Si ya existe un blueprint activo para ese repo y ámbito, la solicitud devuelve 409; usa el endpoint de actualización en su lugar.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

org_id
string
requerido

ID de la organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

Cuerpo

application/json
contents
string | null

Cuerpo YAML inicial opcional para el blueprint.

repo_name
string | null

Si se establece, crea un blueprint de nivel de repo para ese repositorio. Si se omite, crea un blueprint para toda la organización (nivel de organización).

Respuesta

Respuesta satisfactoria

Esquema público del recurso Blueprint.

Nota: el enum type puede ampliarse en el futuro; los clientes DEBEN manejar correctamente los valores desconocidos. El contenido YAML se obtiene por separado mediante GET /blueprints/{id}/contents.

blueprint_id
string
requerido
created_at
integer
requerido
repo_name
string | null
requerido
type
enum<string>
requerido
Opciones disponibles:
enterprise,
org,
repo
updated_at
integer
requerido