Mettre à jour la règle

Met à jour une règle d'enregistrement SAML existante.

Endpoint

PUT /api/Rule

Corps de la requête

Champ	Saisie de texte	Requis	Description
ruleId	Entier	Oui (Yes)	L'identifiant unique de la règle à mettre à jour
partitionGlobalId	GUID	Oui (Yes)	L’identifiant global de l’organisation. Pour obtenir des étapes sur la récupération partitionGlobalId, consultez la section Récupération de l’ID partitionGlobalId pour utiliser l’API.
name	Chaîne de caractères (string)	Oui (Yes)	Nom de la règle mis à jour
description	Chaîne de caractères (string)	Non (No)	Description mise à jour
enabled	Booléen	Oui (Yes)	Indique si la règle est active
definition	Chaîne de caractères (string)	Non (No)	La définition de la règle

En-têtes de requête.

--header 'Authorization: Bearer {access_token}'
--header 'Content-Type: application/json'

Réponses

Remarque :

Le point de terminaison Mettre à jour la règle ne renvoie pas de RuleDto. Les groupes attribués ne sont pas renvoyés.

{
  "id": 3685,
  "name": "Test",
  "description": "Test",
  "enabled": true,
  "partitionId": 28728,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}",
  "creationTime": "2026-01-29T16:09:41.7203623",
  "lastModificationTime": "2026-01-29T16:11:18.691478Z"
}

Exemple de requête

{
  "ruleId": 3685,
  "partitionGlobalId": "{{prtId}}",
  "name": "Test",
  "description": "Test",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}"
}

Réponses d’erreur

• 400 Bad Request: Corps de requête non valide ou erreurs de validation
• 401 Unauthorized: jeton d’authentification manquant ou non valide
• 403 Forbidden: Autorisations insuffisantes
• 404 Not Found: l’organisation ou la règle n’existe pas