Zum Hauptinhalt springen
GET
Automatisierung abrufen

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken mit der Berechtigung ViewOrgAutomations auf Organisationsebene.

Autorisierungen

Authorization
string
header
erforderlich

Anmeldedaten für Service-Benutzer (Präfix: cog_)

Pfadparameter

automation_id
string
erforderlich
org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Antwort

Erfolgreiche Antwort

automation_id
string
erforderlich
name
string
erforderlich
enabled
boolean
erforderlich
triggers
AutomationTriggerResponse · object[]
erforderlich
actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
erforderlich
created_by
ActorResponse · object
erforderlich

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

created_at
integer
erforderlich
updated_at
integer
erforderlich
notifications
AutomationNotifications · object | null
tools
AutomationTools · object | null
metadata
Metadata · object
limits
AutomationLimits · object | null
concurrency
AutomationConcurrency · object | null
session_settings
AutomationSessionSettings · object | null

Wird auf jede von dieser Automatisierung gestartete Sitzung angewendet (einschließlich Überwachungs- sitzungen).

security_profile
AutomationSecurityProfileResponse · object | null

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

run_as
AutomationRunAsOrganization · object

Identität, unter der die erstellten Sitzungen ausgeführt werden. organization: die Automatisierungsidentität der Organisation. Wenn die Organisation einen Standard-Service-Benutzer für Automatisierungen hat, werden Sitzungen als dieser Service-Benutzer ausgeführt und die Antwort gibt run_as service_user mit dessen ID zurück; zum Speichern sind alle Berechtigungen erforderlich, die dieser Service-Benutzer besitzt. Ohne einen solchen Service-Benutzer wird das Erstellen einer Automatisierung oder das Speichern einer aktivierten Automatisierung abgelehnt. MCP-Server, die mit einer persönlichen (nutzerbezogenen) Verbindung installiert wurden und mit denen sich dieser Service-Benutzer nicht verbunden hat, können nicht ausgewählt werden, und beim Wechsel einer Automatisierung zu 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 von Service-Benutzern erstellte Automatisierungen nicht zulässig. service_user: wird unter der Identität des angegebenen Service-Benutzers mit dessen Rollen, Zugriffsrechten und ACU-Limits ausgeführt; erfordert die Berechtigung zur Verwaltung dieses Service-Benutzers. Bei der Erstellung erforderlich; null beim Update setzt den Wert auf organization zurück.

slack_reply_access
enum<string>
Standard:slack_users

Wer aus Slack-Threads in bestehenden Sitzungen antworten darf: devin_users (nur Nutzer mit verknüpften Devin-Konten), slack_users (alle Nutzer in den verbundenen Slack-Workspaces der Organisation) oder external_slack_users (auch Slack Connect-Nutzer). Hat keinen Einfluss darauf, wer die Automatisierung auslösen kann.

Verfügbare Optionen:
devin_users,
slack_users,
external_slack_users
teams_reply_access
enum<string>
Standard:teams_users

Wer aus Microsoft Teams-Threads in bestehenden Sitzungen antworten darf: devin_users (nur Nutzer mit verknüpften Devin-Konten) oder teams_users (alle Nutzer im verbundenen Microsoft-Mandanten der Organisation; Standard). Hat keinen Einfluss darauf, wer die Automatisierung auslösen kann.

Verfügbare Optionen:
devin_users,
teams_users
template_id
string | 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
next_run_at
integer | null

Wann die Zeitplan-Auslöser der Automatisierung das nächste Mal ausgelöst werden. null, wenn die Automatisierung keinen Zeitplan-Auslöser hat, deaktiviert ist oder das Enddatum aller Zeitpläne überschritten ist.