Zum Hauptinhalt springen
PATCH
Ein Security Profile auf Enterprise-Ebene aktualisieren
Aktualisiert ein Security Profile, das der Enterprise gehört. Laufende Sitzungen behalten die Einschränkungen bei, die beim letzten Start oder Aufwachen für sie ermittelt wurden. Änderungen gelten sofort für neue Sitzungen und für bestehende Sitzungen, sobald diese das nächste Mal wiederaufgenommen werden.

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken mit der Berechtigung ManageAccountSecureModeProfiles auf Enterprise-Ebene. Nur für Enterprise-Konten verfügbar.

Verhalten

  • Weggelassene Felder bleiben unverändert.
  • Ein explizites null löscht die Vorgabe des Profils für net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope und teams_group_chat_scope. Bei allen anderen Feldern wird null abgelehnt.
  • net_policy: null bedeutet, dass das Profil keine Netzwerkvorgabe hat – nicht, dass alles verweigert wird. Um alles zu verweigern, verwenden Sie {"allow": []}.
  • mcp_config.servers listet MCP-Server anhand ihres Slugs auf (ein Marketplace-Slug wie github oder der Slug einer Installation).

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

profile_id
string
erforderlich

Body

application/json

PATCH-Semantik: Ausgelassene Felder bleiben unverändert; ein explizites null löscht die Felder, die null zulassen (net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope, teams_group_chat_scope), und wird für die übrigen abgelehnt.

devin_mcp_read_only
boolean | null
enforcement_level
enum<string> | null
Verfügbare Optionen:
recommended,
mandatory
git_access_level
enum<string> | null
Verfügbare Optionen:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
name
string | null
Required string length: 1 - 128
net_policy
SecurityProfileNetPolicy · object | null
remove_github_cli_token
boolean | null
slack_channel_access
SecurityProfileSlackChannelAccess · object | null
slack_dm_scope
enum<string> | null
Verfügbare Optionen:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null
teams_dm_scope
enum<string> | null
Verfügbare Optionen:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null
Verfügbare Optionen:
disabled,
origin_chat

Antwort

Erfolgreiche Antwort

Ein Security Profile im Besitz eines Enterprise, das allen Organisationen im Enterprise zur Verfügung steht. Das zugehörige Enterprise ergibt sich aus dem Token des Aufrufers.

created_at
integer
erforderlich
devin_mcp_read_only
boolean
erforderlich

Bei true dürfen Sitzungen nur Devin-MCP-Tools mit reinem Lesezugriff aufrufen (keine Sitzungserstellung, Automatisierungsverwaltung oder sonstigen Schreiboperationen).

enforcement_level
enum<string>
erforderlich

Profile vom Typ recommended können durch untergeordnete Bindungen überschrieben werden; Profile vom Typ mandatory legen Mindestbeschränkungen fest, die untergeordnete Richtlinien nur verschärfen dürfen.

Verfügbare Optionen:
recommended,
mandatory
git_access_level
enum<string>
erforderlich
Verfügbare Optionen:
read_only,
read_write
name
string
erforderlich
profile_id
string
erforderlich

Die ID des Security Profiles.

remove_github_cli_token
boolean
erforderlich

Bei true wird das GitHub-CLI-Token vom Rechner der Sitzung entfernt und damit der direkte Zugriff auf die GitHub-API verhindert.

updated_at
integer
erforderlich
mcp_config
SecurityProfileMcpConfig · object | null

null = dieses Profil macht keine Vorgabe für MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = dieses Profil macht keine Netzwerkvorgabe (das bedeutet NICHT, dass alles gesperrt ist).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Begrenzt, in welchen Slack-Kanälen Sitzungen unter diesem Profil lesen und posten dürfen. null = dieses Profil macht keine Vorgabe; es gilt die Slack-Einstellung der Organisation.

slack_dm_scope
enum<string> | null

Begrenzt, wer Devin unter diesem Profil Direktnachrichten in Slack senden darf. null = dieses Profil macht keine Vorgabe; es gilt die Slack-Einstellung der Organisation. 'workspace' wird bei Enterprise-Konten auf 'org_members' eingeschränkt.

Verfügbare Optionen:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Begrenzt, in welchen Microsoft-Teams-Kanälen Sitzungen unter diesem Profil lesen und posten dürfen. null = dieses Profil macht keine Vorgabe; es gilt der Teams-Standardzugriff der Organisation.

teams_dm_scope
enum<string> | null

Begrenzt, wem Devin unter diesem Profil Direktnachrichten in Microsoft Teams senden darf. null = dieses Profil macht keine Vorgabe; es gilt der Teams-Standardzugriff der Organisation.

Verfügbare Optionen:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Begrenzt, welche Teams-Gruppenchats Devin unter diesem Profil lesen darf; origin_chat = nur der Gruppenchat, aus dem die Sitzung gestartet wurde; null = keine Vorgabe, der Zugriff wird wie bei Direktnachrichten aus dem Teams-Standardzugriff der Organisation abgeleitet.

Verfügbare Optionen:
disabled,
origin_chat