> ## 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.

# Listar los perfiles de seguridad de la empresa

> Listar los perfiles de seguridad de la empresa, compartidos con todas sus
organizaciones. Los perfiles propios de cada organización se listan en las rutas de esa organización.

Devuelve, de forma paginada, los perfiles de seguridad de la empresa. Estos perfiles se comparten con todas las organizaciones de la empresa; para obtener los perfiles propios de cada organización, usa [Listar perfiles de seguridad de la organización](https://docs.devinenterprise.com/es/api-reference/v3/security-profiles/list-organizations-security-profiles.md).

Consulta [Perfiles de seguridad](https://docs.devinenterprise.com/es/product-guides/security-profiles.md) para saber qué hace cada restricción y cómo se resuelven los perfiles.

## Permisos

Requiere un [usuario de servicio](https://docs.devinenterprise.com/es/api-reference/v3/service-users/members-service-users.md) o un [token de acceso personal](https://docs.devinenterprise.com/es/api-reference/personal-access-tokens.md) con el permiso `ManageAccountSecureModeProfiles` a nivel empresarial. Solo disponible en cuentas empresariales.


## OpenAPI

````yaml es/v3-openapi.yaml GET /v3beta1/enterprise/security-profiles
openapi: 3.1.0
info:
  description: API de Devin v3 con autenticación mediante usuario de servicio y RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3beta1/enterprise/security-profiles:
    get:
      tags:
        - security-profiles
      summary: Listar los perfiles de seguridad de la empresa
      description: >-
        Listar los perfiles de seguridad de la empresa, compartidos con todas
        sus

        organizaciones. Los perfiles propios de cada organización se listan en
        las rutas de esa organización.
      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: Respuesta satisfactoria
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: No autorizado
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Prohibido
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: No Encontrado
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflicto
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Ya no disponible
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenido no procesable
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Demasiadas solicitudes
components:
  schemas:
    PaginatedResponse_EnterpriseSecurityProfileResponse_:
      properties:
        end_cursor:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Cursor para obtener la página siguiente, o None si esta es la última
            página.
          title: End Cursor
        has_next_page:
          default: false
          description: Indica si hay más elementos disponibles después de esta página.
          title: Has Next Page
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/EnterpriseSecurityProfileResponse'
          title: Items
          type: array
        total:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            Recuento total opcional (se puede omitir por motivos de
            rendimiento).
          title: Total
      required:
        - items
      title: PaginatedResponse[EnterpriseSecurityProfileResponse]
      type: object
    ProblemDetail:
      description: >-
        Cuerpo de error RFC 9457 application/problem+json para la API v3.


        detail se conserva del cuerpo heredado {"detail": ...} por
        compatibilidad con versiones anteriores; los

        otros miembros son adicionales. errors contiene errores de validación

        a nivel de campo (solo 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: Explicación legible para humanos específica de esta ocurrencia.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Código legible por máquina que indica el rechazo de una acción
            bloqueada (p. ej., "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Errores de validación por campo (solo en respuestas 422).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: Una referencia URI (la ruta de la solicitud) para esta ocurrencia.
          title: Instance
        status:
          description: El código de estado HTTP.
          title: Status
          type: integer
        title:
          description: Un breve resumen del tipo de problema, legible para humanos.
          title: Title
          type: string
        type:
          default: about:blank
          description: Una referencia URI que identifica el tipo de problema.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    EnterpriseSecurityProfileResponse:
      additionalProperties: false
      description: >-
        Un perfil de seguridad propiedad de una empresa, compartido con todas
        las organizaciones de la

        empresa. La empresa propietaria se deduce del token de quien realiza la
        llamada.
      properties:
        created_at:
          title: Created At
          type: integer
        devin_mcp_read_only:
          description: >-
            Cuando es true, las sesiones solo pueden invocar herramientas MCP de
            Devin de solo lectura (sin creación de sesiones, gestión de
            automatizaciones ni otras operaciones de escritura).
          title: Devin Mcp Read Only
          type: boolean
        enforcement_level:
          description: >-
            los perfiles recomendados pueden sobrescribirse mediante
            asociaciones de niveles inferiores; los perfiles obligatorios
            establecen restricciones mínimas que las políticas de niveles
            inferiores solo pueden hacer más estrictas.
          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 = este perfil no tiene preferencia respecto a MCP.
        name:
          title: Name
          type: string
        net_policy:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileNetPolicy'
            - type: 'null'
          description: >-
            null = este perfil no tiene preferencia respecto a la red (NO
            significa denegar todo).
        profile_id:
          description: El ID del perfil de seguridad.
          title: Profile Id
          type: string
        remove_github_cli_token:
          description: >-
            Cuando es true, el token de la CLI de GitHub se elimina de la
            máquina de la sesión, lo que impide el acceso directo a la API de
            GitHub.
          title: Remove Github Cli Token
          type: boolean
        slack_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileSlackChannelAccess'
            - type: 'null'
          description: >-
            Define los canales de Slack en los que, como máximo, pueden leer y
            publicar las sesiones regidas por este perfil. null = este perfil no
            tiene preferencia y se aplica la configuración de Slack de la
            organización.
        slack_dm_scope:
          anyOf:
            - enum:
                - disabled
                - org_members
                - workspace
              type: string
            - type: 'null'
          description: >-
            Define quiénes pueden, como máximo, enviar mensajes directos a Devin
            en Slack con este perfil. null = este perfil no tiene preferencia y
            se aplica la configuración de Slack de la organización. 'workspace'
            se restringe a 'org_members' para las cuentas empresariales.
          title: Slack Dm Scope
        teams_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileTeamsChannelAccess'
            - type: 'null'
          description: >-
            Define los canales de Microsoft Teams en los que, como máximo,
            pueden leer y publicar las sesiones regidas por este perfil. null =
            este perfil no tiene preferencia y se aplica el acceso
            predeterminado de Teams de la organización.
        teams_dm_scope:
          anyOf:
            - enum:
                - disabled
                - installed_users
              type: string
            - type: 'null'
          description: >-
            Define a quiénes puede, como máximo, enviar Devin mensajes directos
            en Microsoft Teams con este perfil. null = este perfil no tiene
            preferencia y se aplica el acceso predeterminado de Teams de la
            organización.
          title: Teams Dm Scope
        teams_group_chat_scope:
          anyOf:
            - enum:
                - disabled
                - origin_chat
              type: string
            - type: 'null'
          description: >-
            Define los chats de grupo de Teams que, como máximo, puede leer
            Devin con este perfil; `origin_chat` = solo el chat de grupo desde
            el que se inició la sesión; null = sin preferencia, se determina a
            partir del acceso predeterminado de Teams de la organización, al
            igual que con los mensajes directos.
          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: >-
            Servidores MCP que pueden utilizar las sesiones regidas por este
            perfil, identificados por slug: un slug del mercado de aplicaciones
            (el campo slug del recurso mcp-servers, p. ej., 'github', 'notion')
            o el slug de una instalación. Cuando una instalación personalizada
            comparte un slug con un servidor del mercado de aplicaciones,
            prevalece la instalación personalizada.
          items:
            type: string
          title: Servers
          type: array
      required:
        - servers
      title: SecurityProfileMcpConfig
      type: object
    SecurityProfileNetPolicy:
      additionalProperties: false
      properties:
        allow:
          description: >-
            Destinos permitidos; se bloquea todo lo que no figure en la lista.
            Las entradas de nombres de host admiten comodines (p. ej.,
            *.github.com). Una lista vacía es una política válida que deniega
            todo.
          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: >-
            Canales permitidos cuando mode es 'specific'; se ignoran (y se
            devuelven vacíos) en los demás modos.
          items:
            $ref: '#/components/schemas/SecurityProfileSlackChannel'
          title: Channels
          type: array
        mode:
          description: >-
            none = las sesiones no pueden leer ni publicar en ningún canal;
            specific = solo los canales indicados; all_public = cualquier canal
            público del que sea miembro la aplicación de Slack.
          enum:
            - none
            - specific
            - all_public
          title: Mode
          type: string
      required:
        - mode
      title: SecurityProfileSlackChannelAccess
      type: object
    SecurityProfileTeamsChannelAccess:
      additionalProperties: false
      properties:
        channels:
          description: >-
            Canales permitidos cuando el modo es 'specific'; en los demás modos,
            se ignora este campo y se devuelve vacío.
          items:
            $ref: '#/components/schemas/SecurityProfileTeamsChannel'
          title: Channels
          type: array
        mode:
          description: >-
            none = las sesiones no pueden leer ni publicar en ningún canal;
            specific = solo los canales indicados; installed_teams = cualquier
            canal de un equipo en el que esté instalada la aplicación de Devin.
          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 del canal de Slack.
          minLength: 1
          title: Channel Id
          type: string
        team_id:
          description: ID del workspace (equipo) de Slack.
          minLength: 1
          title: Team Id
          type: string
      required:
        - team_id
        - channel_id
      title: SecurityProfileSlackChannel
      type: object
    SecurityProfileTeamsChannel:
      additionalProperties: false
      properties:
        channel_id:
          description: ID del canal de Teams ('19:...@thread.tacv2').
          minLength: 1
          title: Channel Id
          type: string
        team_id:
          description: ID del grupo de Entra correspondiente al equipo de Microsoft Teams.
          minLength: 1
          title: Team Id
          type: string
      required:
        - team_id
        - channel_id
      title: SecurityProfileTeamsChannel
      type: object
  securitySchemes:
    bearerAuth:
      description: 'Credencial de usuario de servicio (prefijo: cog_)'
      scheme: bearer
      type: http

````

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