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

# Afficher la liste des profils de sécurité de l’Enterprise

> Lister les profils de sécurité de l’Enterprise, partagés avec toutes ses
organisations. Les profils propres à chaque organisation sont répertoriés via les chemins d’API de cette organisation.

Renvoie la liste paginée des profils de sécurité de l'Enterprise. Ces profils sont partagés avec toutes les organisations de l'Enterprise ; pour obtenir les profils propres à chaque organisation, utilisez [Lister les profils de sécurité de l'organisation](https://docs.devinenterprise.com/fr/api-reference/v3/security-profiles/list-organizations-security-profiles.md).

Consultez [Profils de sécurité](https://docs.devinenterprise.com/fr/product-guides/security-profiles.md) pour comprendre le rôle de chaque restriction et la manière dont les profils sont déterminés.

## Autorisations

Nécessite un [utilisateur de service](https://docs.devinenterprise.com/fr/api-reference/v3/service-users/members-service-users.md) ou un [jeton d’accès personnel](https://docs.devinenterprise.com/fr/api-reference/personal-access-tokens.md) disposant de l’autorisation `ManageAccountSecureModeProfiles` au niveau Enterprise. Disponible uniquement pour les comptes d’entreprise.


## OpenAPI

````yaml fr/v3-openapi.yaml GET /v3beta1/enterprise/security-profiles
openapi: 3.1.0
info:
  description: API Devin v3 avec authentification par compte de service et RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3beta1/enterprise/security-profiles:
    get:
      tags:
        - security-profiles
      summary: Afficher la liste des profils de sécurité de l’Enterprise
      description: >-
        Lister les profils de sécurité de l’Enterprise, partagés avec toutes ses

        organisations. Les profils propres à chaque organisation sont
        répertoriés via les chemins d’API de cette organisation.
      operationId: handle_list_security_profiles_v3beta1_enterprise_security_profiles_get
      parameters:
        - in: query
          name: after
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: After
        - in: query
          name: first
          required: false
          schema:
            default: 100
            maximum: 200
            minimum: 1
            title: First
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/PaginatedResponse_EnterpriseSecurityProfileResponse_
          description: Réponse réussie
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non autorisé
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Accès interdit
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Introuvable
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflit
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Ressource supprimée
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenu impossible à traiter
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Trop de requêtes
components:
  schemas:
    PaginatedResponse_EnterpriseSecurityProfileResponse_:
      properties:
        end_cursor:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Curseur permettant de récupérer la page suivante, ou None s’il
            s’agit de la dernière page.
          title: End Cursor
        has_next_page:
          default: false
          description: Indique si d’autres éléments sont disponibles après cette page.
          title: Has Next Page
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/EnterpriseSecurityProfileResponse'
          title: Items
          type: array
        total:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            Nombre total facultatif (peut être omis pour des raisons de
            performance).
          title: Total
      required:
        - items
      title: PaginatedResponse[EnterpriseSecurityProfileResponse]
      type: object
    ProblemDetail:
      description: "Corps d’erreur RFC 9457 application/problem+json pour l’API v3.\n\ndetail est conservé de l’ancien corps {\"detail\": ...} pour assurer la rétrocompatibilité\_; les\nautres membres sont ajoutés de manière additive. errors contient les échecs de validation\nau niveau des champs (422 uniquement)."
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: Explication en langage clair, spécifique à cette occurrence.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Code exploitable par machine indiquant le refus d’une action bloquée
            (p. ex. "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Erreurs de validation par champ (réponses 422 uniquement).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: Une référence d’URI (le chemin de la requête) pour cette occurrence.
          title: Instance
        status:
          description: Le code d’état HTTP.
          title: Status
          type: integer
        title:
          description: Un bref résumé du type de problème, compréhensible par un humain.
          title: Title
          type: string
        type:
          default: about:blank
          description: Une référence d’URI identifiant le type de problème.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    EnterpriseSecurityProfileResponse:
      additionalProperties: false
      description: >-
        Un profil de sécurité appartenant à une Enterprise, partagé avec toutes
        les organisations de

        l’Enterprise. L’Enterprise propriétaire est déterminée implicitement par
        le token de l’appelant.
      properties:
        created_at:
          title: Created At
          type: integer
        devin_mcp_read_only:
          description: >-
            Si la valeur est true, les sessions peuvent uniquement appeler les
            outils MCP de Devin en lecture seule (aucune création de session,
            gestion des automatisations ou autre opération d’écriture).
          title: Devin Mcp Read Only
          type: boolean
        enforcement_level:
          description: >-
            Les profils recommandés peuvent être remplacés par des associations
            de niveau inférieur ; les profils obligatoires constituent un socle
            de restrictions que les politiques de niveau inférieur ne peuvent
            que renforcer.
          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 = ce profil n’a aucune préférence concernant MCP.
        name:
          title: Name
          type: string
        net_policy:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileNetPolicy'
            - type: 'null'
          description: >-
            null = ce profil n’a aucune préférence concernant le réseau (cela ne
            signifie PAS que tout est interdit).
        profile_id:
          description: L’ID du profil de sécurité.
          title: Profile Id
          type: string
        remove_github_cli_token:
          description: >-
            Si la valeur est true, le token de l’interface en ligne de commande
            GitHub est supprimé de la machine de la session, ce qui empêche tout
            accès direct à l’API GitHub.
          title: Remove Github Cli Token
          type: boolean
        slack_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileSlackChannelAccess'
            - type: 'null'
          description: >-
            Périmètre maximal des canaux Slack dans lesquels les sessions régies
            par ce profil peuvent lire et publier des messages. null = ce profil
            n’a aucune préférence et le paramètre Slack de l’organisation
            s’applique.
        slack_dm_scope:
          anyOf:
            - enum:
                - disabled
                - org_members
                - workspace
              type: string
            - type: 'null'
          description: >-
            Périmètre maximal des personnes autorisées à envoyer des messages
            directs à Devin dans Slack avec ce profil. null = ce profil n’a
            aucune préférence et le paramètre Slack de l’organisation
            s’applique. 'workspace' est restreint à 'org_members' pour les
            comptes d’entreprise.
          title: Slack Dm Scope
        teams_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileTeamsChannelAccess'
            - type: 'null'
          description: >-
            Périmètre maximal des canaux Microsoft Teams dans lesquels les
            sessions régies par ce profil peuvent lire et publier des messages.
            null = ce profil n’a aucune préférence et le paramètre d’accès par
            défaut à Teams de l’organisation s’applique.
        teams_dm_scope:
          anyOf:
            - enum:
                - disabled
                - installed_users
              type: string
            - type: 'null'
          description: >-
            Périmètre maximal des personnes auxquelles Devin peut envoyer des
            messages directs dans Microsoft Teams avec ce profil. null = ce
            profil n’a aucune préférence et le paramètre d’accès par défaut à
            Teams de l’organisation s’applique.
          title: Teams Dm Scope
        teams_group_chat_scope:
          anyOf:
            - enum:
                - disabled
                - origin_chat
              type: string
            - type: 'null'
          description: >-
            Périmètre maximal des conversations de groupe Teams que Devin peut
            lire avec ce profil ; `origin_chat` = uniquement la conversation de
            groupe depuis laquelle la session a été lancée ; null = aucune
            préférence, l’accès est déterminé à partir du paramètre d’accès par
            défaut à Teams de l’organisation, comme pour les messages directs.
          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
    SecurityProfileMcpConfig:
      additionalProperties: false
      properties:
        servers:
          description: >-
            Serveurs MCP que les sessions régies par ce profil peuvent utiliser,
            indexés par slug : un slug de la place de marché (le champ slug de
            la ressource mcp-servers, p. ex. 'github', 'notion') ou le slug
            d’une installation. Lorsqu’une installation personnalisée possède le
            même slug qu’un serveur de la place de marché, l’installation
            personnalisée prévaut.
          items:
            type: string
          title: Servers
          type: array
      required:
        - servers
      title: SecurityProfileMcpConfig
      type: object
    SecurityProfileNetPolicy:
      additionalProperties: false
      properties:
        allow:
          description: >-
            Destinations autorisées ; toute destination non répertoriée est
            bloquée. Les entrées de noms d’hôtes prennent en charge les
            caractères génériques (p. ex. *.github.com). Une liste vide
            constitue une politique valide qui bloque tout.
          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: >-
            Canaux autorisés lorsque mode vaut 'specific' ; ignorés pour les
            autres modes (une liste vide est alors renvoyée).
          items:
            $ref: '#/components/schemas/SecurityProfileSlackChannel'
          title: Channels
          type: array
        mode:
          description: >-
            none = les sessions ne peuvent lire ni publier dans aucun canal ;
            specific = uniquement les canaux répertoriés ; all_public = tout
            canal public dont l’application Slack est membre.
          enum:
            - none
            - specific
            - all_public
          title: Mode
          type: string
      required:
        - mode
      title: SecurityProfileSlackChannelAccess
      type: object
    SecurityProfileTeamsChannelAccess:
      additionalProperties: false
      properties:
        channels:
          description: >-
            Canaux autorisés lorsque le mode est 'specific' ; ignorés (et
            renvoyés sous forme de liste vide) pour les autres modes.
          items:
            $ref: '#/components/schemas/SecurityProfileTeamsChannel'
          title: Channels
          type: array
        mode:
          description: >-
            none = les sessions ne peuvent lire ni publier dans aucun canal ;
            specific = uniquement les canaux répertoriés ; installed_teams =
            tout canal d’une équipe dans laquelle l’Application Devin est
            installée.
          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: ID du canal Slack.
          minLength: 1
          title: Channel Id
          type: string
        team_id:
          description: ID de l’espace de travail Slack (équipe).
          minLength: 1
          title: Team Id
          type: string
      required:
        - team_id
        - channel_id
      title: SecurityProfileSlackChannel
      type: object
    SecurityProfileTeamsChannel:
      additionalProperties: false
      properties:
        channel_id:
          description: ID du canal Teams ('19:...@thread.tacv2').
          minLength: 1
          title: Channel Id
          type: string
        team_id:
          description: ID du groupe Entra de l’équipe Microsoft Teams.
          minLength: 1
          title: Team Id
          type: string
      required:
        - team_id
        - channel_id
      title: SecurityProfileTeamsChannel
      type: object
  securitySchemes:
    bearerAuth:
      description: "Identifiant de compte de service (préfixe\_: cog_)"
      scheme: bearer
      type: http

````

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