Passer au contenu principal
PATCH
Mettre à jour les paramètres des profils de sécurité de 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 ou un jeton d’accès personnel 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.

Autorisations

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

org_id
string
requis

Identifiant d’organisation (préfixe : org-)

Exemple:

"org-abc123def456"

Corps

application/json

Sémantique PATCH : les champs omis restent inchangés.

automations_default
SecurityProfileDefaultSelection · object | null

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.

default
SecurityProfileDefaultSelection · object | null

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.

Réponse

Réponse réussie

automations_default
SecurityProfileDefaultState · object
requis

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
SecurityProfileDefaultState · object
requis

Vue en lecture d’une association par défaut enregistrée.