Skip to main content
POST
Einen Blueprint auf org- oder Repo-Ebene erstellen

Berechtigungen

Erfordert einen Service-Benutzer mit der Berechtigung ManageRepoBlueprints auf Organisationsebene. Das Erstellen von Blueprints auf Org-Ebene erfordert die Berechtigung ManageOrgSnapshots.

Verhalten

Erstellt einen Blueprint auf Org- oder Repo-Ebene. Ein Blueprint definiert die deklarative Umgebungskonfiguration für Devin-Sitzungen. Änderungen an einem Blueprint lösen nicht automatisch einen Build aus — Sie müssen den builds-Endpunkt explizit aufrufen.
Blueprints existieren nicht unabhängig von Ihrer Umgebungskonfiguration. Das Erstellen eines Blueprints mit einem repo_name fügt dieses Repository auch der Umgebung hinzu — es gibt keinen separaten Endpunkt, um das Repo zuerst zu registrieren. Das Repository wird beim nächsten Build in die Umgebung geklont, und die Indexierung wird dafür gestartet.Auch umgekehrt gilt: Wenn Sie ein Repository aus der Umgebung entfernen (der Schalter In Umgebung einschließen in der UI), werden alle Blueprints für dieses Repo gelöscht, einschließlich aller zugehörigen Workspace-Geltungsbereiche.
Der Repository-Name muss einer sein, auf den Devin über Ihre Git-Integration bereits zugreifen kann (zum Beispiel owner/repo); ein unbekanntes oder nicht zugängliches Repo gibt 404 zurück, und es wird kein Blueprint erstellt. Wenn für dieses Repo und diesen Geltungsbereich bereits ein aktiver Blueprint vorhanden ist, gibt die Anfrage 409 zurück — verwenden Sie stattdessen den Aktualisierungsendpunkt.

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Body

application/json
contents
string | null

Optionaler initialer YAML-Body für das Blueprint.

repo_name
string | null

Wenn gesetzt, wird ein Blueprint auf Repo-Ebene für dieses Repository erstellt. Wenn nicht angegeben, wird ein Blueprint auf Org-Ebene erstellt.

Antwort

Erfolgreiche Antwort

Öffentliches Ressourcenformat für Blueprint.

Hinweis: Das Enum type kann in Zukunft erweitert werden; Clients MÜSSEN unbekannte Werte robust verarbeiten. Der YAML-Inhalt wird separat über GET /blueprints/{id}/contents abgerufen.

blueprint_id
string
erforderlich
created_at
integer
erforderlich
repo_name
string | null
erforderlich
type
enum<string>
erforderlich
Verfügbare Optionen:
enterprise,
org,
repo
updated_at
integer
erforderlich