Clarification on last_updated field scope: Global API Freshness vs. Most Recent Data Change

[carles444]

Hello CDS Working Group,

I'm seeking clarification on the intended scope of the last_updated field in the REST Endpoints specification.

The current definition ("The last time the data in this API was updated") presents an ambiguity regarding implementation. My interpretation is that last_updated represents the last time any entity of the whole API was changed, even though the enpoint is returning Policies, if a Zone has changed later than any Policy this value will have the Zone's updated time value.

I also thought about the possibility that this field would refer to the data that is being returned, so if returning a collection of Policies, the last_updated would refer to the latest time that one of the returned Policies was modified.

Your feedback is appreciated. Thank you.