Skip to main content
GET
Get rule change history
Returns the audit trail of changes for a specific rule. Each entry records a change_type, a timestamp, who made the change, and a snapshot of the full rule at that point in time. The changes object highlights which fields were modified. The snapshot includes rule_set_id. Moving a rule to another set appears in the change trail, so you can reconstruct the rule’s set membership at each version. Use change_type to filter results: created, updated, archived, suspended, or activated. Use from and to (RFC 3339) to narrow results to a specific time window.
For usage patterns and examples, see the Writing Rules guide.

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header.

Path Parameters

id
string<uuid>
required

Rule ID

Query Parameters

change_type
enum<string>

Filter by change type

Available options:
created,
updated,
archived,
suspended,
activated
from
string<date-time>

Start of time window (RFC 3339)

to
string<date-time>

End of time window (RFC 3339)

limit
integer
default:20

Maximum number of results (default 20, max 100)

Required range: x >= 1
cursor
string

Pagination cursor from previous response

Response

Rule change history

data
object[]

Data contains the list of items

pagination
object

Pagination contains cursor information for fetching more results