Configuration Changes REST API

Both endpoints require ConfigurationChangesRead permission (or Admin) and query core PostgreSQL directly.

GET /api/v2/configuration-changes returns an array of change records ordered by timestamp in the requested direction, then ascending ID.

Parameter	Meaning	Default
type	One of FLOW, PLUGIN, ARTIFACT, SITE_SETTING, LOOKUP_TABLE	All types
start	Inclusive RFC3339 timestamp or nonnegative Unix milliseconds	0
end	Inclusive RFC3339 timestamp or nonnegative Unix milliseconds	No upper bound
limit	Number of records, 1–1000	100
offset	Number of records to skip, 0–1000000	0
order	Timestamp order: ASC (oldest first) or DESC (newest first)	ASC

order=ASC (or omitting order) returns the oldest changes first; order=DESC returns the newest first. Ordering is applied in the database before limit and offset. Records with equal timestamps are always ordered by ascending ID.

Invalid filters, including unsupported order values, return HTTP 400. No matches returns [].

curl --get 'http://deltafi.localhost/api/v2/configuration-changes' \
  --data-urlencode 'type=ARTIFACT' --data-urlencode 'limit=25' \
  --data-urlencode 'order=ASC'

Records contain id, timestamp, type, operation, resource, actor, and a details object with operation-specific metadata such as counts, item names, versions, and checksums. Values and payload contents are not captured.

GET /api/v2/configuration-changes/types returns the supported type names.

See Configuration Changes for transaction guarantees.