Delete a Match Rule
Learn how to delete a match rule by updating the L3 configuration and understand the necessary steps to ensure matching is recalculated correctly.
Match rules can be deleted only by updating the L3 configuration. The Match Rule Editor does not support deleting match rules, and there is no API to remove a match rule.
Prerequisites
- Access to update the L3 configuration.
- Understanding of where match rules are defined in the configuration.
Delete a Match Rule
- Use the Configuration API to retrieve and download the tenant's L3 configuration (see GET Configuration).
- Open the downloaded JSON file in your preferred text or JSON editor and locate the match rule inside the
matchGroupssection. - Delete the specific match rule object from the JSON file, without modifying other rules or configuration elements.
- Upload the updated L3 configuration back to the tenant using the Configuration API (see Set Configuration) to apply the changes.Note: After uploading the updated configuration, validate that the tenant configuration was applied successfully by checking for errors in the API response or reviewing the configuration in the tenant.
For more details, see Apply an L3 to a tenant.
To recalculate the matches as per the updated configuration, run the Rebuild Match Table task. This step is optional and is not required for the configuration update to take effect.
Result
The system will stop using the deleted rule for new or updated entities. Existing merges remain unchanged, and potential matches associated with the removed rule will no longer be generated once matching is recalculated.