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

# Aggiorna le impostazioni dei profili di sicurezza dell'azienda

> Aggiorna la selezione predefinita di security-profile per l'azienda. I campi omessi
rimangono invariati. È possibile bloccare solo i profili di proprietà dell'azienda.

Aggiorna la selezione del security-profile per l'impostazione predefinita dell'impresa e restituisce le impostazioni aggiornate.

## Autorizzazioni

Richiede un [utente di servizio](https://docs.devinenterprise.com/it/api-reference/v3/service-users/members-service-users.md) o un [token di accesso personale](https://docs.devinenterprise.com/it/api-reference/personal-access-tokens.md) con l'autorizzazione `ManageAccountSecureModeProfiles` a livello aziendale. Disponibile solo per gli account enterprise.

## Comportamento

* I campi omessi restano invariati. `null` viene rifiutato; per cancellare l'impostazione predefinita, invia `{"default": {"selection": "none"}}`.
* `profile_id` è obbligatorio quando `selection` è `profile` e va omesso negli altri casi. Solo i profili di proprietà dell'azienda possono essere bloccati.
* Un'impostazione predefinita dell'impresa obbligatoria rappresenta una soglia minima: organizzazioni, automazioni e sessioni possono solo renderla più restrittiva. Consulta [applicazione obbligatoria e consigliata](https://docs.devinenterprise.com/it/product-guides/security-profiles.md#mandatory-vs-recommended-enforcement).
* Le sessioni in esecuzione applicano la modifica al successivo avvio o risveglio.


## OpenAPI

````yaml it/v3-openapi.yaml PATCH /v3beta1/enterprise/security-profile-settings
openapi: 3.1.0
info:
  description: API Devin v3 con autenticazione utente di servizio e RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3beta1/enterprise/security-profile-settings:
    patch:
      tags:
        - security-profiles
      summary: Aggiorna le impostazioni dei profili di sicurezza dell'azienda
      description: >-
        Aggiorna la selezione predefinita di security-profile per l'azienda. I
        campi omessi

        rimangono invariati. È possibile bloccare solo i profili di proprietà
        dell'azienda.
      operationId: >-
        handle_update_security_profile_settings_v3beta1_enterprise_security_profile_settings_patch
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/EnterpriseSecurityProfileSettingsUpdateRequest
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnterpriseSecurityProfileSettingsResponse'
          description: Risposta riuscita
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non autorizzato
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Vietato
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non trovato
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflitto
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non più disponibile
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenuto non elaborabile
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Troppe Richieste
components:
  schemas:
    EnterpriseSecurityProfileSettingsUpdateRequest:
      additionalProperties: false
      description: 'Semantica PATCH: i campi omessi restano invariati.'
      properties:
        default:
          anyOf:
            - $ref: '#/components/schemas/EnterpriseSecurityProfileDefaultSelection'
            - type: 'null'
      title: EnterpriseSecurityProfileSettingsUpdateRequest
      type: object
    EnterpriseSecurityProfileSettingsResponse:
      additionalProperties: false
      properties:
        default:
          $ref: '#/components/schemas/EnterpriseSecurityProfileDefaultState'
      required:
        - default
      title: EnterpriseSecurityProfileSettingsResponse
      type: object
    ProblemDetail:
      description: >-
        Corpo dell'errore application/problem+json RFC 9457 per l'API v3.


        detail è mantenuto dal corpo legacy {"detail": ...} per
        retrocompatibilità; gli

        altri membri sono aggiuntivi. errors contiene gli errori di validazione
        a livello di campo

        (solo 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Una spiegazione leggibile dall'utente, specifica per questa
            occorrenza.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Codice elaborabile automaticamente che indica il rifiuto di
            un'azione bloccata (ad es. "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Errori di convalida a livello di campo (solo per le risposte 422).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Un riferimento URI (il percorso della richiesta) per questa
            occorrenza.
          title: Instance
        status:
          description: Il codice di stato HTTP.
          title: Status
          type: integer
        title:
          description: Un breve riepilogo del tipo di problema, leggibile dall'utente.
          title: Title
          type: string
        type:
          default: about:blank
          description: Un riferimento URI che identifica il tipo di problema.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    EnterpriseSecurityProfileDefaultSelection:
      additionalProperties: false
      description: >-
        Un'impostazione predefinita a due stati: none (nessun profilo
        predefinito) o profile (blocca

        profile_id). Non esiste ``inherit`` a livello aziendale: non c'è alcun
        livello

        superiore all'azienda da cui ereditare.
      properties:
        profile_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Obbligatorio quando selection è 'profile'; deve essere omesso negli
            altri casi.
          title: Profile Id
        selection:
          enum:
            - none
            - profile
          title: Selection
          type: string
      required:
        - selection
      title: EnterpriseSecurityProfileDefaultSelection
      type: object
    EnterpriseSecurityProfileDefaultState:
      additionalProperties: false
      description: >-
        Vista in lettura dell'associazione dell'impostazione predefinita
        dell'impresa.
      properties:
        profile_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Profile Id
        selection:
          enum:
            - none
            - profile
          title: Selection
          type: string
      required:
        - selection
      title: EnterpriseSecurityProfileDefaultState
      type: object
  securitySchemes:
    bearerAuth:
      description: 'Credenziale dell''utente del servizio (prefisso: cog_)'
      scheme: bearer
      type: http

````

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