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

# Mettre à jour les paramètres des profils de sécurité de l’organisation

> Mettre à jour les sélections de security-profile par défaut de l’organisation.
Les champs omis restent inchangés. Un profil épinglé peut être org-owned ou
faire partie des profils partagés de l’Enterprise à laquelle appartient l’organisation.

Met à jour les sélections de profils de sécurité par défaut de l'organisation et renvoie les paramètres obtenus.

## 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 `ManageSecureModeProfiles` au niveau de l’organisation. Les jetons utilisés par une session Devin en cours d’exécution sont rejetés : une session ne peut donc pas modifier les profils qui la régissent.

## Comportement

* Les champs omis restent inchangés. La valeur `null` est rejetée ; pour effacer une valeur par défaut, définissez-la sur `inherit`, p. ex. `{"default": {"selection": "inherit"}}` ou `{"automations_default": {"selection": "inherit"}}`.
* `profile_id` est obligatoire lorsque `selection` vaut `profile` et doit être omis dans les autres cas. Le profil épinglé peut être un profil org-owned ou l'un des profils partagés de l'Enterprise.
* Les sessions en cours d'exécution prennent en compte la modification lors de leur prochain démarrage ou de leur prochaine sortie de veille.


## OpenAPI

````yaml fr/v3-openapi.yaml PATCH /v3beta1/organizations/{org_id}/security-profile-settings
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/organizations/{org_id}/security-profile-settings:
    patch:
      tags:
        - security-profiles
      summary: Mettre à jour les paramètres des profils de sécurité de l’organisation
      description: >-
        Mettre à jour les sélections de security-profile par défaut de
        l’organisation.

        Les champs omis restent inchangés. Un profil épinglé peut être org-owned
        ou

        faire partie des profils partagés de l’Enterprise à laquelle appartient
        l’organisation.
      operationId: >-
        handle_update_security_profile_settings_v3beta1_organizations__org_id__security_profile_settings_patch
      parameters:
        - description: 'Identifiant d’organisation (préfixe : org-)'
          in: path
          name: org_id
          required: true
          schema:
            example: org-abc123def456
            title: Org Id
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SecurityProfileSettingsUpdateRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityProfileSettingsResponse'
          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:
    SecurityProfileSettingsUpdateRequest:
      additionalProperties: false
      description: 'Sémantique PATCH : les champs omis restent inchangés.'
      properties:
        automations_default:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileDefaultSelection'
            - type: 'null'
        default:
          anyOf:
            - $ref: '#/components/schemas/SecurityProfileDefaultSelection'
            - type: 'null'
      title: SecurityProfileSettingsUpdateRequest
      type: object
    SecurityProfileSettingsResponse:
      additionalProperties: false
      properties:
        automations_default:
          $ref: '#/components/schemas/SecurityProfileDefaultState'
          description: >-
            Configuration par défaut pour les sessions déclenchées par une
            automatisation. S’intercale entre les configurations par défaut de
            l’organisation ou de l’entreprise et l’association propre à chaque
            automatisation.
        default:
          $ref: '#/components/schemas/SecurityProfileDefaultState'
      required:
        - default
        - automations_default
      title: SecurityProfileSettingsResponse
      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
    SecurityProfileDefaultSelection:
      additionalProperties: false
      description: >-
        Une valeur par défaut à trois états : inherit (aucune association propre
        — hérite de

        la valeur par défaut du niveau parent), none (exclusion explicite :
        aucun profil, même si un

        niveau supérieur définit une valeur par défaut recommandée), ou profile
        (épingle profile_id).


        Une désactivation ne permet pas de contourner un profil obligatoire
        défini à un niveau supérieur : elle est bien enregistrée,

        mais reste sans effet tant que le profil obligatoire existe.
      properties:
        profile_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Requis lorsque selection vaut 'profile' ; doit être omis dans les
            autres cas.
          title: Profile Id
        selection:
          enum:
            - inherit
            - none
            - profile
          title: Selection
          type: string
      required:
        - selection
      title: SecurityProfileDefaultSelection
      type: object
    SecurityProfileDefaultState:
      additionalProperties: false
      description: Vue en lecture d’une association par défaut enregistrée.
      properties:
        profile_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Profile Id
        profile_scope:
          anyOf:
            - enum:
                - org
                - enterprise
              type: string
            - type: 'null'
          description: >-
            Périmètre auquel appartient le profil épinglé. Défini uniquement
            lorsque selection vaut 'profile' ; une configuration par défaut de
            l’organisation peut épingler un profil partagé au niveau de
            l’entreprise.
          title: Profile Scope
        selection:
          enum:
            - inherit
            - none
            - profile
          title: Selection
          type: string
      required:
        - selection
      title: SecurityProfileDefaultState
      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.