Skip to main content
PATCH
Inhalt, Position, Quelle und/oder Commit-Build-Einstellungen eines Blueprints aktualisieren

Berechtigungen

Erforderlich ist ein Service-Benutzer oder ein persönliches Zugriffstoken mit der Berechtigung ManageRepoBlueprints auf Organisationsebene. Zum Erstellen oder Aktualisieren von Blueprints auf Org-Ebene ist die Berechtigung ManageOrgSnapshots erforderlich.

Verhalten

Aktualisiert den Inhalt und/oder die Position eines Blueprints. Ein Build wird nicht automatisch ausgelöst.

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

blueprint_id
string
erforderlich
org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Body

application/json

Partielle Aktualisierung für einen Blueprint auf Organisations- oder Repository-Ebene.

Es kann jede beliebige Teilmenge von Feldern angegeben werden. Nicht gesetzte Felder bleiben unverändert. Die Angabe von position, source oder einer Commit-Build-Einstellung bei einem Blueprint auf Organisationsebene gibt 400 zurück — nur Blueprints auf Repository-Ebene haben diese Felder. Löst KEINEN Build aus.

build_on_default_branch_commit
boolean | null

Falls gesetzt, aktiviert oder deaktiviert diese Einstellung den Build der Umgebung bei jedem Push auf den Standardbranch. Wird nur beim Blueprint im Repository-Stammverzeichnis eines github.com-Repos akzeptiert. Jeder solche Push fügt der Warteschlange einen Build hinzu.

contents
string | null

Wenn gesetzt, ersetzt dies den YAML-Body des Blueprints durch eine neue Version.

position
integer | null

Wenn gesetzt, aktualisiert dies die Ausführungsposition dieses Blueprints auf Repo-Ebene. Positionen müssen nicht eindeutig sein; Gleichstände werden beim Sortieren für die Ausführung vom Server beliebig aufgelöst.

report_check_runs
boolean | null

Falls gesetzt, aktiviert oder deaktiviert diese Einstellung die Meldung jedes Commit-Builds als GitHub-Prüfdurchlauf. Zum Aktivieren muss 'build_on_default_branch_commit' aktiviert sein.

source
enum<string> | null

Wenn angegeben, wird die Blueprint-Quelle des Repos gewechselt. Nur beim Root-Blueprint des Repos zulässig (Blueprints mit eingeschränktem Geltungsbereich erhalten sie durch Vererbung). 'git' ruft .devin/blueprint.yaml vom Standardbranch ab (404, wenn die Datei fehlt) und kann nicht mit 'contents' kombiniert werden; 'database' behält das aktuelle YAML (oder 'contents', falls angegeben) bei und beendet die Synchronisierung mit dem Repo. Bleibt ohne Wirkung, wenn sich der Blueprint bereits in diesem Modus befindet.

Verfügbare Optionen:
git,
database

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
build_on_default_branch_commit
boolean | null

Ob bei jedem Push auf den Standardbranch des Repos ein Build der Umgebung erfolgt. Null, sofern dies kein Blueprint im Repository-Stammverzeichnis eines Repos ist.

report_check_runs
boolean | null

Ob jeder Commit-Build als GitHub-Prüfdurchlauf für den Commit gemeldet wird. Null, sofern dies kein Blueprint im Repository-Stammverzeichnis eines Repos ist.

source
enum<string> | null

Wo die YAML-Datei erstellt und bearbeitet wird: 'git' (aus .devin/blueprint.yaml im Repo synchronisiert) oder 'database' (über die API/Benutzeroberfläche bearbeitet). Für Blueprints auf Enterprise- und Org-Ebene immer null.

Verfügbare Optionen:
git,
database