Zum Hauptinhalt springen
PATCH
Ein Security Profile der Organisation aktualisieren
Aktualisiert ein Security Profile im Besitz einer Organisation. Laufende Sitzungen behalten die Einschränkungen bei, die beim letzten Start oder Aufwachen ermittelt wurden. Änderungen gelten für neue Sitzungen sofort 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 ManageSecureModeProfiles auf Organisationsebene. Tokens, die von einer laufenden Devin-Sitzung verwendet werden, werden abgelehnt. So kann eine Sitzung die für sie geltenden Profile nicht ändern.

Verhalten

  • Ausgelassene 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 jeglicher Zugriff 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
org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

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, das einer Organisation gehört.

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, Verwaltung von Automatisierungen oder sonstige Schreiboperationen).

enforcement_level
enum<string>
erforderlich

Empfohlene Profile können durch untergeordnete Bindungen überschrieben werden; verbindliche Profile legen Mindestbeschränkungen fest, die untergeordnete Richtlinien nur verschärfen können.

Verfügbare Optionen:
recommended,
mandatory
git_access_level
enum<string>
erforderlich
Verfügbare Optionen:
read_only,
read_write
name
string
erforderlich
org_id
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, wodurch der direkte Zugriff auf die GitHub-API verhindert wird.

updated_at
integer
erforderlich
mcp_config
SecurityProfileMcpConfig · object | null

null = dieses Profil macht keine MCP-Vorgabe.

net_policy
SecurityProfileNetPolicy · object | null

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

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Legt fest, in welchen Slack-Kanälen Sitzungen unter diesem Profil höchstens lesen und Beiträge veröffentlichen dürfen. null = dieses Profil macht keine Vorgabe und es gilt die Slack-Einstellung der Organisation.

slack_dm_scope
enum<string> | null

Legt fest, wer Devin unter diesem Profil in Slack höchstens Direktnachrichten senden darf. null = dieses Profil macht keine Vorgabe und 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

Legt fest, in welchen Microsoft-Teams-Kanälen Sitzungen unter diesem Profil höchstens lesen und Beiträge veröffentlichen dürfen. null = dieses Profil macht keine Vorgabe und es gilt der Teams-Standardzugriff der Organisation.

teams_dm_scope
enum<string> | null

Legt fest, wem Devin unter diesem Profil in Microsoft Teams höchstens Direktnachrichten senden darf. null = dieses Profil macht keine Vorgabe und es gilt der Teams-Standardzugriff der Organisation.

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

Legt fest, welche Teams-Gruppenchats Devin unter diesem Profil höchstens lesen darf; origin_chat = nur der Gruppenchat, aus dem die Sitzung gestartet wurde; null = keine Vorgabe, die Berechtigung wird wie bei Direktnachrichten vom Teams-Standardzugriff der Organisation abgeleitet.

Verfügbare Optionen:
disabled,
origin_chat