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

# Obter um perfil de segurança da organização

> Obter um dos perfis de segurança da própria organização pelo ID.

Retorna um dos perfis de segurança da própria organização. Perfis compartilhados pela empresa não são retornados por este caminho.

Consulte [Perfis de segurança](https://docs.devinenterprise.com/pt-BR/product-guides/security-profiles.md) para saber o que cada restrição faz e como os perfis são resolvidos.

## Permissões

Requer um [usuário de serviço](https://docs.devinenterprise.com/pt-BR/api-reference/v3/service-users/members-service-users.md) ou um [token de acesso pessoal](https://docs.devinenterprise.com/pt-BR/api-reference/personal-access-tokens.md) com a permissão `ManageSecureModeProfiles` no nível da organização. Tokens usados por uma sessão do Devin em execução são rejeitados, para que uma sessão não possa alterar os perfis que a regem.


## OpenAPI

````yaml pt-BR/v3-openapi.yaml GET /v3beta1/organizations/{org_id}/security-profiles/{profile_id}
openapi: 3.1.0
info:
  description: API Devin v3 com autenticação de usuário de serviço e 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: Obter um perfil de segurança da organização
      description: Obter um dos perfis de segurança da própria organização pelo 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 da organização (prefixo: 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: Resposta Bem-Sucedida
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Não autorizado
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Proibido
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Não Encontrado
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflito
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Removido
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conteúdo Não Processável
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Excesso de requisições
components:
  schemas:
    SecurityProfileResponse:
      additionalProperties: false
      description: Um perfil de segurança pertencente à organização.
      properties:
        created_at:
          title: Created At
          type: integer
        devin_mcp_read_only:
          description: >-
            Quando true, as sessões só podem chamar ferramentas somente de
            leitura do Devin MCP (sem criação de sessões, gerenciamento de
            automações ou outras operações de gravação).
          title: Devin Mcp Read Only
          type: boolean
        enforcement_level:
          description: >-
            perfis recomendados podem ser substituídos por vinculações
            descendentes; perfis obrigatórios estabelecem um nível mínimo de
            restrição que as políticas descendentes só podem tornar mais
            rigoroso.
          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 não define uma preferência de MCP.
        name:
          title: Name
          type: string
        net_policy:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileNetPolicy'
            - type: 'null'
          description: >-
            null = este perfil não define uma preferência de rede (NÃO significa
            bloquear tudo).
        org_id:
          title: Org Id
          type: string
        profile_id:
          description: O ID do perfil de segurança.
          title: Profile Id
          type: string
        remove_github_cli_token:
          description: >-
            Quando true, o token da CLI do GitHub é removido da máquina da
            sessão, impedindo o acesso direto à API do GitHub.
          title: Remove Github Cli Token
          type: boolean
        slack_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileSlackChannelAccess'
            - type: 'null'
          description: >-
            Restrição que define em quais canais do Slack as sessões regidas por
            este perfil podem ler e publicar mensagens. null = este perfil não
            define uma preferência e aplica-se a configuração do Slack da
            organização.
        slack_dm_scope:
          anyOf:
            - enum:
                - disabled
                - org_members
                - workspace
              type: string
            - type: 'null'
          description: >-
            Restrição que define quem pode enviar mensagens diretas ao Devin no
            Slack com este perfil. null = este perfil não define uma preferência
            e aplica-se a configuração do Slack da organização. 'workspace' fica
            restrito a 'org_members' para contas empresariais.
          title: Slack Dm Scope
        teams_channel_access:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileTeamsChannelAccess'
            - type: 'null'
          description: >-
            Restrição que define em quais canais do Microsoft Teams as sessões
            regidas por este perfil podem ler e publicar mensagens. null = este
            perfil não define uma preferência e aplica-se o Acesso Padrão do
            Teams da organização.
        teams_dm_scope:
          anyOf:
            - enum:
                - disabled
                - installed_users
              type: string
            - type: 'null'
          description: >-
            Restrição que define a quem o Devin pode enviar mensagens diretas no
            Microsoft Teams com este perfil. null = este perfil não define uma
            preferência e aplica-se o Acesso Padrão do Teams da organização.
          title: Teams Dm Scope
        teams_group_chat_scope:
          anyOf:
            - enum:
                - disabled
                - origin_chat
              type: string
            - type: 'null'
          description: >-
            Restrição que define quais conversas em grupo do Teams o Devin pode
            ler com este perfil; `origin_chat` = apenas a conversa em grupo na
            qual a sessão foi iniciada; null = nenhuma preferência, com a
            configuração derivada do Acesso Padrão do Teams da organização,
            assim como nas mensagens diretas.
          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: >-
        Corpo de erro RFC 9457 application/problem+json da API v3.


        detail é mantido do corpo legado {"detail": ...} por
        retrocompatibilidade; os

        outros membros são aditivos. errors contém falhas de validação em nível
        de campo

        (apenas 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: Uma explicação legível por humanos específica para esta ocorrência.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Código legível por máquina para recusas de ações bloqueadas (por
            exemplo, "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Erros de validação no nível do campo (apenas respostas 422).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Uma referência de URI (o caminho da requisição) para esta
            ocorrência.
          title: Instance
        status:
          description: O código de status HTTP.
          title: Status
          type: integer
        title:
          description: Um breve resumo do tipo de problema, legível para humanos.
          title: Title
          type: string
        type:
          default: about:blank
          description: Uma referência de URI que identifica o tipo de problema.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    SecurityProfileMcpConfig:
      additionalProperties: false
      properties:
        servers:
          description: >-
            Servidores MCP que as sessões regidas por este perfil podem usar,
            indexados por slug: um slug do marketplace (o campo slug do recurso
            mcp-servers, p. ex., 'github', 'notion') ou o slug de uma
            instalação. Quando uma instalação personalizada tem o mesmo slug de
            um servidor do marketplace, a instalação personalizada prevalece.
          items:
            type: string
          title: Servers
          type: array
      required:
        - servers
      title: SecurityProfileMcpConfig
      type: object
    SecurityProfileNetPolicy:
      additionalProperties: false
      properties:
        allow:
          description: >-
            Destinos permitidos; tudo o que não estiver na lista será bloqueado.
            Entradas de nomes de host aceitam curingas (p. ex., *.github.com).
            Uma lista vazia é uma política válida de bloqueio total.
          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: >-
            Canais permitidos quando mode é 'specific'; nos demais modos, são
            ignorados e a lista é retornada vazia.
          items:
            $ref: '#/components/schemas/SecurityProfileSlackChannel'
          title: Channels
          type: array
        mode:
          description: >-
            none = as sessões não podem ler nem publicar em nenhum canal;
            specific = somente os canais listados; all_public = qualquer canal
            público do qual o app do Slack seja membro.
          enum:
            - none
            - specific
            - all_public
          title: Mode
          type: string
      required:
        - mode
      title: SecurityProfileSlackChannelAccess
      type: object
    SecurityProfileTeamsChannelAccess:
      additionalProperties: false
      properties:
        channels:
          description: >-
            Canais permitidos quando o modo é 'specific'; nos demais modos, a
            lista é ignorada e retornada vazia.
          items:
            $ref: '#/components/schemas/SecurityProfileTeamsChannel'
          title: Channels
          type: array
        mode:
          description: >-
            none = as sessões não podem ler nem publicar em nenhum canal;
            specific = somente os canais listados; installed_teams = qualquer
            canal de uma equipe na qual o aplicativo Devin esteja instalado.
          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 do canal do Slack.
          minLength: 1
          title: Channel Id
          type: string
        team_id:
          description: ID do workspace (equipe) do 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 do canal do Teams ('19:...@thread.tacv2').
          minLength: 1
          title: Channel Id
          type: string
        team_id:
          description: ID do grupo do Entra associado à equipe do Microsoft Teams.
          minLength: 1
          title: Team Id
          type: string
      required:
        - team_id
        - channel_id
      title: SecurityProfileTeamsChannel
      type: object
  securitySchemes:
    bearerAuth:
      description: 'Credencial de usuário de serviço (prefixo: cog_)'
      scheme: bearer
      type: http

````

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