Skip to main content
POST
Creare un blueprint di livello org o repo

Autorizzazioni

Richiede un utente di servizio 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.

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).

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