Skip to main content
PATCH
Automatisierung aktualisieren

Berechtigungen

Erfordert einen Service-Benutzer mit der Berechtigung ManageOrgAutomations auf Organisationsebene.

Merge-Semantik

Bei der Standardsemantik merge_patch werden PATCH-Felder auf Mitgliedsebene zusammengeführt (nach RFC 7396): Nicht übermittelte Mitglieder behalten ihren gespeicherten Wert, explizite Nullwerte löschen sie, und leere Gruppen sind No-Ops. Metadaten werden pro Schlüssel zusammengeführt, wobei Nullwerte Schlüssel löschen. Listen werden vollständig ersetzt. Jedes gesendete Element wird jedoch mit dem gespeicherten Element desselben Typs zusammengeführt, sofern dieser Typ auf beiden Seiten genau einmal vorkommt. Bei der Semantik replace_groups wird nichts zusammengeführt: Eine gesendete Objektgruppe ersetzt die gespeicherte Gruppe vollständig, und eine gesendete Liste triggers oder actions ersetzt die gespeicherte Liste vollständig ohne elementweise Zusammenführung. Übermitteln Sie jedes Mitglied erneut, das Sie beibehalten möchten – nicht übermittelte Mitglieder werden gelöscht oder auf ihren Standardwert zurückgesetzt. metadata wird ebenfalls vollständig ersetzt. Um einen Schlüssel zu entfernen, übermitteln Sie den Satz erneut, ohne diesen Schlüssel einzuschließen. Nullwerte für Metadaten werden mit einem Fehler 400 abgelehnt, anstatt Schlüssel zu löschen. Nicht übermittelte Felder der obersten Ebene bleiben unverändert. Prüfen Sie vor der Nutzung eines der beiden Verhaltensweisen im Feld update_semantics des Endpunkts für Ereignisschemas, welche Semantik für Ihre Organisation aktiv ist. Behandeln Sie es als offene Enum und tolerieren Sie auch andere Werte als die beiden oben genannten.

Webhook-Auslöser

Durch erneutes Hinzufügen eines webhook:incoming-Auslösers wird ein neues Secret generiert und in der Aktualisierungsantwort zurückgegeben. Das Secret wird nur dann angezeigt. Speichern Sie es daher, sobald Sie es erhalten. Beim Ersetzen oder Beibehalten eines vorhandenen Webhook-Auslösers bleibt das vorhandene Secret erhalten.

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

automation_id
string
erforderlich
org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Body

application/json

PATCH-Felder werden standardmäßig eigenschaftsweise zusammengeführt: Weggelassene Eigenschaften bleiben erhalten, ausdrückliche null-Werte löschen sie, und leere Gruppen haben keine Wirkung. Metadaten werden pro Schlüssel zusammengeführt, wobei null-Werte Schlüssel löschen. Listen werden vollständig ersetzt (Löschen = erneutes Senden der Liste ohne das Element), während jedes gesendete Element mit dem gespeicherten Element desselben Typs zusammengeführt wird, wenn dieser Typ auf beiden Seiten genau einmal vorkommt. Elementeigenschaften, die beim Erstellen erforderlich sind (prompt, setup_prompt, die Slack-Konfigurationen für Überwachung/Triage, scan_id), können weggelassen werden, wenn ein Gegenstück vorhanden ist – sie werden wie jede andere Eigenschaft übernommen; ausdrückliches null wird abgelehnt.

actions
(AutomationStartSessionActionUpdate · object | AutomationMessageSessionActionUpdate · object | AutomationMonitorSessionActionUpdate · object)[] | null
concurrency
AutomationConcurrency · object | null
enabled
boolean | null
limits
AutomationLimits · object | null
metadata
Metadata · object | null
name
string | null
Required string length: 1 - 500
notifications
AutomationNotifications · object | null
run_as
AutomationRunAsOrganization · object

Identität, unter der die gestarteten Sitzungen ausgeführt werden. organization: die Automatisierungsidentität der Organisation (der System User in der App) – Sitzungen verwenden Systemberechtigungen, daher können MCP-Server, die mit einer persönlichen (nutzerbezogenen) Verbindung installiert wurden, nicht ausgewählt werden. Wird eine Automatisierung auf organization umgestellt, werden sie aus ihrer Auswahl entfernt. creator: persönliche Automatisierung – wird mit den eigenen Berechtigungen des Erstellers ausgeführt und ist nur für den Ersteller und Organisationsadministratoren sichtbar; wird für von Service-Benutzern erstellte Automatisierungen abgelehnt. Beim Erstellen erforderlich; null bei Aktualisierung setzt auf organization zurück.

security_profile
AutomationSecurityProfileSelection · object | null

Die eigene Sicherheitsprofilbindung der Automatisierung: Eine profile_id pinnt dieses Profil, {"profile_id": null} speichert eine ausdrückliche Abwahl und ausdrückliches null stellt die Vererbung von der Organisation/dem Enterprise wieder her. Erfordert die Berechtigung zur Verwaltung von Sicherheitsprofilen.

session_settings
AutomationSessionSettings · object | null

Wird auf jede Sitzung angewendet, die diese Automatisierung startet (einschließlich Überwachungssitzungen).

tools
AutomationTools · object | null
triggers
AutomationTriggerRequest · object[] | null

Antwort

Erfolgreiche Antwort

actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
erforderlich
automation_id
string
erforderlich
created_at
integer
erforderlich
created_by
ActorResponse · object
erforderlich

Ein Nutzer- oder Service-Benutzer-Principal, der einer Action oder Ressource zugeordnet ist.

enabled
boolean
erforderlich
name
string
erforderlich
triggers
AutomationTriggerResponse · object[]
erforderlich
updated_at
integer
erforderlich
concurrency
AutomationConcurrency · object | null
last_edited_by
ActorResponse · object | null

Ein Nutzer- oder Service-Benutzer-Principal, der einer Action oder Ressource zugeordnet ist.

last_invocation
AutomationLastInvocation · object | null
limits
AutomationLimits · object | null
metadata
Metadata · object
notifications
AutomationNotifications · object | null
run_as
AutomationRunAsOrganization · object

Identität, unter der gestartete Sitzungen ausgeführt werden. organization: die Automatisierungsidentität der Organisation (der System User in der App) — Sitzungen verwenden Systemberechtigungen, daher können MCP-Server mit einer persönlichen (nutzerbezogenen) Verbindung nicht ausgewählt werden; beim Umschalten einer Automatisierung auf organization werden sie aus der Auswahl entfernt. creator: persönliche Automatisierung — wird mit den Berechtigungen des Erstellers ausgeführt und ist nur für den Ersteller und Organisationsadministratoren sichtbar; für Automatisierungen, die von Service-Benutzern erstellt wurden, nicht zulässig. Beim Erstellen erforderlich; null bei Updates setzt den Wert auf organization zurück.

security_profile
AutomationSecurityProfileResponse · object | null

Die Sicherheitsprofilbindung der Automatisierung und die ermittelten maßgeblichen Profile. null, wenn Sicherheitsprofile für die Organisation nicht aktiviert sind.

session_settings
AutomationSessionSettings · object | null

Wird auf jede Sitzung angewendet, die diese Automatisierung startet (einschließlich Überwachungssitzungen).

template_id
string | null
tools
AutomationTools · object | null