Supprimer une règle d'automatisation

Supprime définitivement une règle d'automatisation et, en cascade, son historique d'exécutions.

Réponse exemple

{
  "id": "a3f1c8e2-7b94-4d51-9f2a-1c6e8d0b4f73",
  "object": "rule",
  "deleted": true
}

DELETE/v1/rules/{id}Supprime définitivement une règle d'automatisation.

Supprime définitivement une règle d'automatisation de l'espace de travail. La suppression est irréversible et entraîne en cascade la suppression de l'historique d'exécutions associé à la règle. La règle est résolue par son id et le workspace_id du jeton : une règle d'un autre espace de travail renvoie 404.

Authentification

Cette requête nécessite une clé API valide dont le jeton porte le scope transfers:manage. Sans ce scope, la requête renvoie 403 scope_missing.

Paramètres de requête

Paramètre	Type	Emplacement	Description
id	string (UUID)	Chemin	Identifiant de la règle à supprimer. Doit appartenir à l'espace de travail du jeton.

Réponse

Retourne un accusé de suppression contenant id (l'identifiant supprimé), object valant "rule", et deleted valant true. Aucun contenu de la règle n'est renvoyé.

Champ	Type	Description
id	string	Identifiant de la règle supprimée.
object	string	Toujours "rule".
deleted	boolean	Toujours true en cas de succès.

Erreurs

Code	Quand	Résolution
401 invalid_api_key	Clé API absente, invalide, expirée ou révoquée.	Vérifiez l'en-tête Authorization.
403 scope_missing	Le jeton ne porte pas le scope transfers:manage.	Générez une clé incluant transfers:manage.
404 not_found	Aucune règle avec cet id dans l'espace de travail (déjà supprimée ou inexistante).	Vérifiez l'identifiant ; une suppression déjà effectuée renvoie 404.
429 rate_limited	Quota de requêtes d'écriture dépassé.	Patientez selon l'en-tête Retry-After.
500 internal_error	Erreur interne lors de la suppression.	Réessayez ; contactez le support avec le request_id si persistant.

Voir aussi

PATCH /v1/rules/{id} — désactiver une règle sans la supprimer.
GET /v1/rules/{id} — vérifier l'existence d'une règle avant suppression.
GET /v1/rules — lister les règles restantes.