Summary
The User Rules dependents endpoints are being updated to improve API design and extensibility. Currently, these endpoints return a ruleId property directly. This property will now be represented as a rule object in the response.
This change allows additional rule-related properties to be included in the future and supports potential expand capabilities. These endpoints are currently in PREVIEW.
Effective Date
Friday, January 30, 2026
Details
Exposing rule information as an object through the dependents endpoints reduces the need for additional API calls and improves consistency with API design best practices.
Customer Impact
Customers currently accessing the ruleId property in responses from the User Rules dependents endpoints must update their implementations to retrieve the rule identifier from the rule object instead.
Impacted Resources
/api/v2/users/rules/{ruleId}/dependents
/api/v2/users/rules/{ruleId}/dependents/{ruleType}/{typeId}
Issue References
PDNA-26995
Contacts
@Kevin Grey Please reply to this announcement with any questions. This helps the wider developer community benefit from the discussion. We encourage you to use this thread before contacting the designated person directly. Thank you for your understanding.