.. _links: Links ===== Links to other resources often need to be represented in responses. There is already a well established format for this representation in `JSON Hyper-Schema: Hypertext definitions for JSON Schema `_. This is already the `prevailing representation `_ in use by a number of prominent OpenStack projects and also in use by the :ref:`errors` guideline. .. note:: Before inventing a new value for ``rel``, please check the existing `Link Relations `_ for something you can reuse. Links Example ------------- .. code-block:: javascript { "links": [ { "rel": "help", "href": "http://developer.openstack.org/api-ref/compute/#create-server" } ] }