The schema defines the format of the request and response data. It uses the JsonSchema format. Inside a schema it is possible to refer to other schema definitions by using the $ref key and the schema protocol i.e. schema:///[schema-name]. More detailed information about the json schema format at the RFC.


    "id": "",
    "type": "object",
    "title": "schema",
    "properties": {
        "name": {
            "type": "string"
        "author": {
            "$ref": "schema:///author"
        "date": {
            "type": "string",
            "format": "date-time"