> ## 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 auf Enterprise-Ebene erstellen

> Ein Security Profile erstellen, das dem Enterprise gehört.

Erstellt ein Security Profile, das zur Enterprise gehört und für alle ihre Organisationen freigegeben ist. Organisationen können es auswählen, bearbeiten können es jedoch nur Enterprise-Admins. Um es unternehmensweit anzuwenden, verwenden Sie [Enterprise-Standardprofil festlegen](https://docs.devin.ai/de/api-reference/v3/security-profiles/patch-enterprise-security-profile-settings.md).

## 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 `ManageAccountSecureModeProfiles` auf Enterprise-Ebene. Nur für Enterprise-Konten verfügbar.

## Verhalten

* Nur `name` ist erforderlich. Profilnamen müssen innerhalb des Enterprise eindeutig sein.
* Wenn `net_policy` weggelassen wird, beginnt das Profil mit einer Positivliste, die nur den Host der Git-Integration enthält (derselbe Ausgangspunkt wie auf der Settings-Seite). Ein explizites `null` bedeutet, dass das Profil keine Netzwerkvorgaben macht – und nicht, dass alles verweigert wird.
* `remove_github_cli_token` ist standardmäßig `true`. Um den Token beizubehalten (`false`), ist `git_access_level: read_write` erforderlich sowie – sofern eine Netzwerkrichtlinie festgelegt ist – eine Positivliste, die `api.github.com` enthält.
* `git_access_level` ist standardmäßig `read_write`, `enforcement_level` standardmäßig `recommended`.


## OpenAPI

````yaml de/v3-openapi.yaml POST /v3beta1/enterprise/security-profiles
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/enterprise/security-profiles:
    post:
      tags:
        - security-profiles
      summary: Ein Security Profile auf Enterprise-Ebene erstellen
      description: Ein Security Profile erstellen, das dem Enterprise gehört.
      operationId: handle_create_security_profile_v3beta1_enterprise_security_profiles_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SecurityProfileCreateRequest'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnterpriseSecurityProfileResponse'
          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:
    SecurityProfileCreateRequest:
      additionalProperties: false
      properties:
        devin_mcp_read_only:
          default: false
          title: Devin Mcp Read Only
          type: boolean
        enforcement_level:
          default: recommended
          enum:
            - recommended
            - mandatory
          title: Enforcement Level
          type: string
        git_access_level:
          default: read_write
          enum:
            - read_only
            - read_write
          title: Git Access Level
          type: string
        mcp_config:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileMcpConfig'
            - type: 'null'
        name:
          maxLength: 128
          minLength: 1
          title: Name
          type: string
        net_policy:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileNetPolicy'
            - type: 'null'
          description: >-
            Weggelassen = eine Allowlist, die nur den Host der Git-Integration
            enthält (derselbe Ausgangswert wie in der UI für
            Sicherheitsprofile); explizites null = dieses Profil macht keine
            Netzwerkvorgabe (das bedeutet NICHT, dass alles verweigert wird). Da
            die Standard-Allowlist api.github.com nicht enthält, muss bei einer
            Anfrage mit remove_github_cli_token=false net_policy explizit
            angegeben werden (gegebenenfalls als null).
        remove_github_cli_token:
          default: true
          title: Remove Github Cli Token
          type: boolean
        slack_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileSlackChannelAccess'
            - type: 'null'
          description: >-
            Weggelassen oder null = dieses Profil macht keine Vorgabe für
            Slack-Kanäle (es gilt die Slack-Einstellung der Organisation).
        slack_dm_scope:
          anyOf:
            - enum:
                - disabled
                - org_members
                - workspace
              type: string
            - type: 'null'
          description: >-
            Weggelassen oder null = dieses Profil macht keine Vorgabe für
            Slack-Direktnachrichten (es gilt die Slack-Einstellung der
            Organisation).
          title: Slack Dm Scope
        teams_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileTeamsChannelAccess'
            - type: 'null'
          description: >-
            Weggelassen oder null = dieses Profil macht keine Vorgabe für
            Teams-Kanäle (es gilt der Teams-Standardzugriff der Organisation).
        teams_dm_scope:
          anyOf:
            - enum:
                - disabled
                - installed_users
              type: string
            - type: 'null'
          description: >-
            Weggelassen oder null = dieses Profil macht keine Vorgabe für
            Teams-Direktnachrichten (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: >-
            Weggelassen oder null = dieses Profil macht keine Vorgabe für
            Teams-Gruppenchats (wie bei Direktnachrichten wird die Vorgabe vom
            Teams-Standardzugriff der Organisation abgeleitet).
          title: Teams Group Chat Scope
      required:
        - name
      title: SecurityProfileCreateRequest
      type: object
    EnterpriseSecurityProfileResponse:
      additionalProperties: false
      description: >-
        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.
      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, Automatisierungsverwaltung oder
            sonstigen Schreiboperationen).
          title: Devin Mcp Read Only
          type: boolean
        enforcement_level:
          description: >-
            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.
          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 Vorgabe für MCP.
        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 gesperrt ist).
        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
            und damit der direkte Zugriff auf die GitHub-API verhindert.
          title: Remove Github Cli Token
          type: boolean
        slack_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileSlackChannelAccess'
            - type: 'null'
          description: >-
            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:
          anyOf:
            - enum:
                - disabled
                - org_members
                - workspace
              type: string
            - type: 'null'
          description: >-
            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.
          title: Slack Dm Scope
        teams_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileTeamsChannelAccess'
            - type: 'null'
          description: >-
            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:
          anyOf:
            - enum:
                - disabled
                - installed_users
              type: string
            - type: 'null'
          description: >-
            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.
          title: Teams Dm Scope
        teams_group_chat_scope:
          anyOf:
            - enum:
                - disabled
                - origin_chat
              type: string
            - type: 'null'
          description: >-
            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.
          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
      title: EnterpriseSecurityProfileResponse
      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.