Conversation
robinbisping
left a comment
There was a problem hiding this comment.
There is an additional file that probably should be updated: /reference/public-api/changelog/
| @@ -1,189 +0,0 @@ | |||
| title: Patch a Media Library Entry | |||
There was a problem hiding this comment.
The preserveUpdatedAt parameter is only available in API versions 2026-03 and newer. Deleting this file makes it now appear as if it were available for all API versions.
It's different from the {{< added-in "release-2026-03" block >}} tag, which are about the release not the API version.
I would restore the file, what do you think? 🤔
There was a problem hiding this comment.
Wouldn't that mean that (almost) every time we have a changelog entry we should also have a new page? I don't think we've done it this way previously, although I'm not against it. Should I open another PR to add more versions?
There was a problem hiding this comment.
Maybe @marcbachmann can explain his intention ones again. I'm not sure. My understanding is that functionality restricted to certain API versions should only appear in the docs for these API versions (e.g. preserveUpdatedAt). On the other hand, features added to all API versions (e.g. the new usage log commands) don't require new pages.
There was a problem hiding this comment.
Yes, every release that got an addition needs to be new yaml declaration. And the apiVersionConstraints should be aligned.
So basically copy the file without release postfix in the name to the older release till it was valid and change the apiVersionConstaints to fit the ranges.
addUsageLogEntry,updateUsageLogEntryandremoveUsageLogEntryoperations to media library patch endpoint of the Public API