Add an alias for `filepath` in Release and Release Links APIs
Problem
The Release and Release Links APIs accept a filepath
parameter which represents a permanent link to an asset in the endpoints to:
That name isn't the best; it's not very descriptive and it collides with other parameters we want to add to this resource (see discussion here).
Proposal
Add an alias for filepath
called direct_asset_path
in aforementioned endpoints.
This can be done utilising the renaming feature of grape
.
What about GraphQL?
This parameter is only used as an input - the filepath
parameter doesn't exist in any API responses. And since our GraphQL release data is read-only at the moment, this feature isn't yet implemented. So there is no conversion work to be done on the GraphQL side. Once we implement release creation/updating through GraphQL, we will use whatever field name we decide on in this issue.
Update as of January 17th, 2022: field name decided is direct_asset_path
.