Skip to main content
POST
Crea un modello a livello org o repo

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con l’autorizzazione ManageRepoBlueprints a livello dell’organizzazione. La creazione di blueprint a livello org richiede l’autorizzazione ManageOrgSnapshots.

Comportamento

Crea un blueprint di livello org o repo. Un blueprint definisce la configurazione dichiarativa dell’ambiente per le sessioni di Devin. La modifica di un blueprint non attiva automaticamente una build: devi chiamare esplicitamente l’endpoint builds.
I blueprint non esistono indipendentemente dalla configurazione del tuo ambiente. La creazione di un blueprint con un repo_name aggiunge anche quel repository all’ambiente: non esiste un endpoint separato per registrare prima il repo. Il repository viene clonato nell’ambiente alla build successiva e ne viene avviata l’indicizzazione.Vale anche il contrario: rimuovere un repository dall’ambiente (l’interruttore Includi nell’ambiente nell’UI) elimina tutti i blueprint per quel repo, inclusi tutti i relativi ambiti del workspace.
Il nome del repository deve essere uno a cui Devin può già accedere tramite la tua integrazione Git (ad esempio owner/repo); un repo sconosciuto o inaccessibile restituisce 404 e non viene creato alcun blueprint. Se esiste già un blueprint attivo per quel repo e ambito, la richiesta restituisce 409: utilizza invece l’endpoint di aggiornamento.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Corpo

application/json
contents
string | null

Corpo YAML iniziale facoltativo per il blueprint. Non consentito con source='git' (i contenuti provengono dal repo).

repo_name
string | null

Se impostato, crea un blueprint di livello repo per quel repository. Se omesso, crea un blueprint org-wide (a livello org).

source
enum<string> | null

Solo a livello di repo. 'git' legge .devin/blueprint.yaml (e i file inclusi) dal branch predefinito del repo e mantiene la blueprint sincronizzata con il file; 'database' memorizza lo YAML in Devin. Se omesso, il valore predefinito è 'database'.

Opzioni disponibili:
git,
database

Risposta

Risposta riuscita

Forma pubblica della risorsa Blueprint.

Note: l'enum type potrebbe estendersi in futuro; i client DEVONO gestire correttamente i valori sconosciuti. Il contenuto YAML viene recuperato separatamente tramite GET /blueprints/{id}/contents.

blueprint_id
string
obbligatorio
created_at
integer
obbligatorio
repo_name
string | null
obbligatorio
type
enum<string>
obbligatorio
Opzioni disponibili:
enterprise,
org,
repo
updated_at
integer
obbligatorio
build_on_default_branch_commit
boolean | null

Indica se ogni push al branch predefinito del repo avvia la build dell'ambiente. null se non si tratta del modello radice di un repo.

report_check_runs
boolean | null

Indica se ogni build di un commit viene riportata sul commit come run di un controllo GitHub. null se non si tratta del modello radice di un repo.

source
enum<string> | null

Dove viene creato il file YAML: 'git' (sincronizzato da .devin/blueprint.yaml nel repository) o 'database' (modificato tramite API/interfaccia utente). Sempre null per i blueprint a livello enterprise e org.

Opzioni disponibili:
git,
database