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

# Obtener un perfil de seguridad de la organización

> Obtener uno de los perfiles de seguridad propios de la organización por su ID.

Devuelve uno de los perfiles de seguridad propios de la organización. Esta ruta no devuelve los perfiles compartidos a nivel de Enterprise.

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 `ManageSecureModeProfiles` a nivel de organización. Se rechazan los tokens que usa una sesión de Devin en ejecución, de modo que una sesión no puede modificar los perfiles que la rigen.


## OpenAPI

````yaml es/v3-openapi.yaml GET /v3beta1/organizations/{org_id}/security-profiles/{profile_id}
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/organizations/{org_id}/security-profiles/{profile_id}:
    get:
      tags:
        - security-profiles
      summary: Obtener un perfil de seguridad de la organización
      description: >-
        Obtener uno de los perfiles de seguridad propios de la organización por
        su ID.
      operationId: >-
        handle_get_security_profile_v3beta1_organizations__org_id__security_profiles__profile_id__get
      parameters:
        - in: path
          name: profile_id
          required: true
          schema:
            title: Profile Id
            type: string
        - description: 'ID de organización (prefijo: org-)'
          in: path
          name: org_id
          required: true
          schema:
            example: org-abc123def456
            title: Org Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityProfileResponse'
          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: Eliminado
        '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:
    SecurityProfileResponse:
      additionalProperties: false
      description: Un perfil de seguridad que pertenece a una organización.
      properties:
        created_at:
          title: Created At
          type: integer
        devin_mcp_read_only:
          description: >-
            Cuando es true, las sesiones solo pueden invocar herramientas de
            Devin MCP 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 quedar anulados por asociaciones de
            niveles inferiores; los perfiles obligatorios establecen unas
            restricciones mínimas que las políticas de niveles inferiores solo
            pueden endurecer.
          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 sobre MCP.
        name:
          title: Name
          type: string
        net_policy:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileNetPolicy'
            - type: 'null'
          description: >-
            null = este perfil no tiene preferencia en materia de red (NO
            significa denegar todo).
        org_id:
          title: Org Id
          type: string
        profile_id:
          description: El ID del perfil de seguridad.
          title: Profile Id
          type: string
        remove_github_cli_token:
          description: >-
            Cuando es true, se elimina el token de la CLI de GitHub 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: >-
            Restricción de los canales de Slack en los que las sesiones regidas
            por este perfil pueden leer y publicar. 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: >-
            Restricción de quién puede 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: >-
            Restricción de los canales de Microsoft Teams en los que las
            sesiones regidas por este perfil pueden leer y publicar. 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: >-
            Restricción de los destinatarios a los que Devin puede enviar
            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: >-
            Restricción de los chats grupales de Teams que Devin puede leer con
            este perfil; `origin_chat` = solo el chat grupal desde el que se
            inició la sesión; null = sin preferencia, se deriva del acceso
            predeterminado de Teams de la organización, como ocurre 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
        - org_id
      title: SecurityProfileResponse
      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
    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.