Ein Portfolio in verständlichen Schritten umziehen

Stapelarbeit ist so aufgebaut, dass nichts geändert wird, bevor ein Mensch den genauen Plan gesehen und genehmigt hat. Du brauchst eine Verbindung mit portfolios:read, portfolios:write, portfolios:execute und approvals:request sowie die casa-Berechtigungen für die geplanten Aktionen.

Den Bestand importieren

POST /workspaces/{id}/portfolios nimmt eine CSV mit Kopfzeile item_key,domain,source_url,world_handle,template_id,content_language oder dieselben Felder als items[], bis zu 1000 Zeilen, mit preserve_existing_mx: true. Jede Zeile wird einzeln geprüft: Domains werden normalisiert, Duplikate und unsichere URLs blockiert, und an einer Quelle gefundener Text wird als nicht vertrauenswürdige Daten gespeichert. Sonst passiert noch nichts.

Einen Probelaufplan vorbereiten und lesen

POST /workspaces/{id}/bulk-plans nimmt die gewünschten Aktionen (create_draft, apply_import, set_dna, publish und Domainschritte), Budgetobergrenzen und rollout_batches, etwa [5, 95]: zuerst fünf Testeinträge, dann der Rest. Die Antwort ist ein unveränderliches Manifest mit seinem plan_hash. Lies es mit GET /bulk-plans/{plan_id}: jeden Schritt pro Eintrag, seine Änderungen und seine Rücksetzbarkeit. DNS-Schritte berühren nur Websiteeinträge und lassen Maileinträge unverändert. Pläne laufen nach 24 Stunden ab.

Den Inhaber um Genehmigung bitten

POST /workspaces/{id}/approvals bindet den genauen plan_hash, die Obergrenzen und eine Ablaufzeit und liefert eine approval_url. Nur ein Inhaber kann nach erneuter Anmeldung im Browser durch Bestätigung des gezeigten Hashes entscheiden. Ein geänderter Plan kann niemals eine Genehmigung wiederverwenden, und ein Token kann niemals genehmigen.

Ausführen, beobachten und steuern

• POST /bulk-plans/{plan_id}/execute mit plan_hash und approval_id startet den einen Lauf, den die Genehmigung erlaubt. Der Teststapel läuft zuerst; continue startet den Rest.
• Beobachte GET /bulk-runs/{run_id} oder die Webhooks job.updated und job.item.updated.
• pause, resume, cancel und retry steuern den Lauf; abgeschlossene Schritte werden nicht wiederholt. rollback macht unveränderte Schreibvorgänge des Laufs rückgängig.

Registrierungen, gesendete Nachrichten und bereits vergangene DNS-Propagation sind nicht umkehrbar und werden niemals als zurückgesetzt gemeldet. Der Tokenwiderruf stoppt neue Arbeit beim nächsten Schritt.

Was heute aktiv ist

Import, Prüfung, Probelaufpläne und Genehmigungen funktionieren überall. Die Ausführung läuft in Entwicklungs- und Testumgebungen vollständig gegen simulierte Domain-, DNS- und Zertifikatsanbieter. In Produktion bleibt sie ausgeschaltet, bis echte Anbieter verbunden sind. GET /capabilities meldet dies als bulk.execute.