I am adding the comment about 'rel' back in - the todo about canonical URL's is done with all the mumbo-jumbo about 'spec_url' which points to somewhere underneath http://api.puppetlabs.com/razor/v1