more work on fleshing out the hypermedia api