Given the following URL: /nodes/
root/children?relativePath=/folderA/folderB the caller wants the ability to optionally return the node information for folderB as well as it's list of children.
If folderB has children, each entry will have a parentId property which can be used to make an additional request to get the required information, however, if folderB has no children the entries array will be empty leaving the client no way to find out the id of folderB which is required for performing operations against i.e. copy/move.
The proposal is to add the ability via an includeSource query parameter to include the default representation of the targeted entity, folderB, in the example above. The presence of the parameter with a value of "true" will effectively cause the framework to include the response of the readById() method for the entity within the list response.
Additional Example Requests
NOTE: We will attempt to keep the "source" property within "list", if too difficult it can go outside.