> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ein Security Profile der Organisation aktualisieren

> Ein organisationseigenes Security Profile aktualisieren. Nicht angegebene Felder bleiben
unverändert; ein expliziter null-Wert löscht net_policy / mcp_config.

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](https://docs.devin.ai/de/api-reference/v3/service-users/members-service-users.md) oder ein [persönliches Zugriffstoken](https://docs.devin.ai/de/api-reference/personal-access-tokens.md) 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).


## OpenAPI

````yaml de/v3-openapi.yaml PATCH /v3beta1/organizations/{org_id}/security-profiles/{profile_id}
openapi: 3.1.0
info:
  description: Devin v3 API mit Service-User-Authentifizierung und RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3beta1/organizations/{org_id}/security-profiles/{profile_id}:
    patch:
      tags:
        - security-profiles
      summary: Ein Security Profile der Organisation aktualisieren
      description: >-
        Ein organisationseigenes Security Profile aktualisieren. Nicht
        angegebene Felder bleiben

        unverändert; ein expliziter null-Wert löscht net_policy / mcp_config.
      operationId: >-
        handle_update_security_profile_v3beta1_organizations__org_id__security_profiles__profile_id__patch
      parameters:
        - in: path
          name: profile_id
          required: true
          schema:
            title: Profile Id
            type: string
        - description: 'Organisations-ID (Präfix: org-)'
          in: path
          name: org_id
          required: true
          schema:
            example: org-abc123def456
            title: Org Id
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SecurityProfileUpdateRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityProfileResponse'
          description: Erfolgreiche Antwort
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Nicht authentifiziert
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Zugriff verweigert
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Nicht gefunden
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Konflikt
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Nicht mehr verfügbar
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Nicht verarbeitbarer Inhalt
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Zu viele Anfragen
components:
  schemas:
    SecurityProfileUpdateRequest:
      additionalProperties: false
      description: >-
        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.
      properties:
        devin_mcp_read_only:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Devin Mcp Read Only
        enforcement_level:
          anyOf:
            - enum:
                - recommended
                - mandatory
              type: string
            - type: 'null'
          title: Enforcement Level
        git_access_level:
          anyOf:
            - enum:
                - read_only
                - read_write
              type: string
            - type: 'null'
          title: Git Access Level
        mcp_config:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileMcpConfig'
            - type: 'null'
        name:
          anyOf:
            - maxLength: 128
              minLength: 1
              type: string
            - type: 'null'
          title: Name
        net_policy:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileNetPolicy'
            - type: 'null'
        remove_github_cli_token:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Remove Github Cli Token
        slack_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileSlackChannelAccess'
            - type: 'null'
        slack_dm_scope:
          anyOf:
            - enum:
                - disabled
                - org_members
                - workspace
              type: string
            - type: 'null'
          title: Slack Dm Scope
        teams_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileTeamsChannelAccess'
            - type: 'null'
        teams_dm_scope:
          anyOf:
            - enum:
                - disabled
                - installed_users
              type: string
            - type: 'null'
          title: Teams Dm Scope
        teams_group_chat_scope:
          anyOf:
            - enum:
                - disabled
                - origin_chat
              type: string
            - type: 'null'
          title: Teams Group Chat Scope
      title: SecurityProfileUpdateRequest
      type: object
    SecurityProfileResponse:
      additionalProperties: false
      description: Ein Security Profile, das einer Organisation gehört.
      properties:
        created_at:
          title: Created At
          type: integer
        devin_mcp_read_only:
          description: >-
            Bei true dürfen Sitzungen nur Devin MCP-Tools mit reinem Lesezugriff
            aufrufen (keine Sitzungserstellung, Verwaltung von Automatisierungen
            oder sonstige Schreiboperationen).
          title: Devin Mcp Read Only
          type: boolean
        enforcement_level:
          description: >-
            Empfohlene Profile können durch untergeordnete Bindungen
            überschrieben werden; verbindliche Profile legen
            Mindestbeschränkungen fest, die untergeordnete Richtlinien nur
            verschärfen können.
          enum:
            - recommended
            - mandatory
          title: Enforcement Level
          type: string
        git_access_level:
          enum:
            - read_only
            - read_write
          title: Git Access Level
          type: string
        mcp_config:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileMcpConfig'
            - type: 'null'
          description: null = dieses Profil macht keine MCP-Vorgabe.
        name:
          title: Name
          type: string
        net_policy:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileNetPolicy'
            - type: 'null'
          description: >-
            null = dieses Profil macht keine Netzwerkvorgabe (das bedeutet
            NICHT, dass alles verweigert wird).
        org_id:
          title: Org Id
          type: string
        profile_id:
          description: Die ID des Security Profiles.
          title: Profile Id
          type: string
        remove_github_cli_token:
          description: >-
            Bei true wird das GitHub-CLI-Token vom Rechner der Sitzung entfernt,
            wodurch der direkte Zugriff auf die GitHub-API verhindert wird.
          title: Remove Github Cli Token
          type: boolean
        slack_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileSlackChannelAccess'
            - type: 'null'
          description: >-
            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:
          anyOf:
            - enum:
                - disabled
                - org_members
                - workspace
              type: string
            - type: 'null'
          description: >-
            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.
          title: Slack Dm Scope
        teams_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileTeamsChannelAccess'
            - type: 'null'
          description: >-
            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:
          anyOf:
            - enum:
                - disabled
                - installed_users
              type: string
            - type: 'null'
          description: >-
            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.
          title: Teams Dm Scope
        teams_group_chat_scope:
          anyOf:
            - enum:
                - disabled
                - origin_chat
              type: string
            - type: 'null'
          description: >-
            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.
          title: Teams Group Chat Scope
        updated_at:
          title: Updated At
          type: integer
      required:
        - profile_id
        - name
        - git_access_level
        - enforcement_level
        - devin_mcp_read_only
        - remove_github_cli_token
        - created_at
        - updated_at
        - org_id
      title: SecurityProfileResponse
      type: object
    ProblemDetail:
      description: >-
        RFC 9457 application/problem+json-Fehlertext für die v3-API.


        detail wird aus dem Legacy-Body {"detail": ...} aus Gründen der
        Abwärtskompatibilität beibehalten; die

        anderen Member sind additiv. errors enthält Validierungsfehler auf
        Feldebene

        (nur 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: Eine menschenlesbare Erklärung, die speziell für diesen Fall gilt.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Maschinenlesbarer Code für die Ablehnung blockierter Aktionen (z. B.
            "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Validierungsfehler auf Feldebene (nur bei 422-Antworten).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: Eine URI-Referenz (der Anfragepfad) für diesen Fall.
          title: Instance
        status:
          description: Der HTTP-Statuscode.
          title: Status
          type: integer
        title:
          description: Eine kurze, menschenlesbare Zusammenfassung des Problemtyps.
          title: Title
          type: string
        type:
          default: about:blank
          description: Eine URI-Referenz, die den Problemtyp identifiziert.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    SecurityProfileMcpConfig:
      additionalProperties: false
      properties:
        servers:
          description: >-
            MCP-Server, die Sitzungen unter diesem Profil verwenden dürfen, mit
            dem jeweiligen Slug als Schlüssel: einem Marketplace-Slug (dem Feld
            slug der Ressource mcp-servers, z. B. 'github', 'notion') oder dem
            Slug einer Installation. Wenn eine benutzerdefinierte Installation
            denselben Slug wie ein Marketplace-Server hat, hat die
            benutzerdefinierte Installation Vorrang.
          items:
            type: string
          title: Servers
          type: array
      required:
        - servers
      title: SecurityProfileMcpConfig
      type: object
    SecurityProfileNetPolicy:
      additionalProperties: false
      properties:
        allow:
          description: >-
            Zulässige Ziele; alles nicht Aufgeführte wird blockiert.
            Hostnameneinträge unterstützen Platzhalter (z. B. *.github.com).
            Eine leere Liste ist eine gültige Richtlinie, die alles verweigert.
          items:
            anyOf:
              - $ref: '#/components/schemas/SecurityProfileHostnameDestination'
              - $ref: '#/components/schemas/SecurityProfileIpv4Destination'
              - $ref: '#/components/schemas/SecurityProfileIpv6Destination'
          title: Allow
          type: array
      required:
        - allow
      title: SecurityProfileNetPolicy
      type: object
    SecurityProfileSlackChannelAccess:
      additionalProperties: false
      properties:
        channels:
          description: >-
            Zulässige Channel, wenn mode den Wert 'specific' hat; bei den
            anderen Modi wird diese Angabe ignoriert und als leer zurückgegeben.
          items:
            $ref: '#/components/schemas/SecurityProfileSlackChannel'
          title: Channels
          type: array
        mode:
          description: >-
            none = Sitzungen dürfen in keinem Channel lesen oder posten;
            specific = nur die aufgeführten Channel; all_public = jeder
            öffentliche Channel, in dem die Slack-App Mitglied ist.
          enum:
            - none
            - specific
            - all_public
          title: Mode
          type: string
      required:
        - mode
      title: SecurityProfileSlackChannelAccess
      type: object
    SecurityProfileTeamsChannelAccess:
      additionalProperties: false
      properties:
        channels:
          description: >-
            Zulässige Channel im Modus 'specific'; bei den anderen Modi
            ignoriert (und leer zurückgegeben).
          items:
            $ref: '#/components/schemas/SecurityProfileTeamsChannel'
          title: Channels
          type: array
        mode:
          description: >-
            none = Sitzungen dürfen in keinem Channel lesen oder posten;
            specific = nur die aufgeführten Channel; installed_teams = jeder
            Channel eines Teams, in dem die Devin-App installiert ist.
          enum:
            - none
            - specific
            - installed_teams
          title: Mode
          type: string
      required:
        - mode
      title: SecurityProfileTeamsChannelAccess
      type: object
    SecurityProfileHostnameDestination:
      additionalProperties: false
      properties:
        hostname:
          title: Hostname
          type: string
      required:
        - hostname
      title: SecurityProfileHostnameDestination
      type: object
    SecurityProfileIpv4Destination:
      additionalProperties: false
      properties:
        ipv4:
          title: Ipv4
          type: string
      required:
        - ipv4
      title: SecurityProfileIpv4Destination
      type: object
    SecurityProfileIpv6Destination:
      additionalProperties: false
      properties:
        ipv6:
          title: Ipv6
          type: string
      required:
        - ipv6
      title: SecurityProfileIpv6Destination
      type: object
    SecurityProfileSlackChannel:
      additionalProperties: false
      properties:
        channel_id:
          description: Slack-Kanal-ID.
          minLength: 1
          title: Channel Id
          type: string
        team_id:
          description: ID des Slack-Workspaces (Teams).
          minLength: 1
          title: Team Id
          type: string
      required:
        - team_id
        - channel_id
      title: SecurityProfileSlackChannel
      type: object
    SecurityProfileTeamsChannel:
      additionalProperties: false
      properties:
        channel_id:
          description: Teams-Channel-ID ('19:...@thread.tacv2').
          minLength: 1
          title: Channel Id
          type: string
        team_id:
          description: Entra-Gruppen-ID des Microsoft-Teams-Teams.
          minLength: 1
          title: Team Id
          type: string
      required:
        - team_id
        - channel_id
      title: SecurityProfileTeamsChannel
      type: object
  securitySchemes:
    bearerAuth:
      description: 'Servicebenutzer-Anmeldedaten (Präfix: cog_)'
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.