[x] On the requests list, say what they each are for.
[ ] Is there still both a '/html' and a '/json'? You should be able to instead use the request headers to determine what the client wants.
[x] According to REST principles, for uploading a file and therefore adding a new resource to the file collection, the request should be a POST /file, not POST /file-upload.
[x] Response outlines. Can you make links to the files, rather than just the file names?
file
collection, the request should be aPOST /file
, notPOST /file-upload
.