{
  "openapi": "3.2.0",
  "info": {
    "title": "JSKOS API",
    "version": "2.2"
  },
  "servers": [
    {
      "title": "BARTOC API",
      "url": "https://bartoc.org/api/",
      "x-version": "2.7.2"
    }
  ],
  "paths": {
    "/status": {
      "get": {
        "summary": "Returns status of the service",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-status"
        }
      }
    },
    "/openapi.json": {
      "get": {
        "summary": "Return API specification as OpenAPI Description",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-openapijson"
        }
      }
    },
    "/checkAuth": {
      "get": {
        "summary": "Check whether a user is authorized and which access rights are granted",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-checkuth"
        }
      }
    },
    "/voc/": {
      "get": {
        "summary": "Lists details of concept schemes",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-voc"
        }
      },
      "post": {
        "summary": "Save concept schemes in the database",
        "security": [
          {
            "bearerJWT": []
          }
        ],
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#post-voc"
        }
      },
      "put": {
        "summary": "Update a concept scheme in the database",
        "security": [
          {
            "bearerJWT": []
          }
        ],
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#put-voc"
        }
      }
    },
    "/voc/suggest": {
      "get": {
        "summary": "Return search suggestions for concept schemes",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-vocsuggest"
        }
      }
    },
    "/voc/search": {
      "get": {
        "summary": "Search for concept schemes",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-vocsearch"
        }
      }
    },
    "/voc/top": {
      "get": {
        "summary": "Returns top concepts of a concept scheme",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-voctop"
        }
      }
    },
    "/voc/concepts": {
      "get": {
        "summary": "Returns all concepts of a concept scheme",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-vocconcepts"
        }
      }
    },
    "/mappings/suggest": {
      "get": {
        "summary": "Suggests notations used in mappings",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-mappingssuggest"
        }
      }
    },
    "/mappings/voc": {
      "get": {
        "summary": "Returns all concept schemes used in mappings",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-mappingsvoc"
        }
      }
    },
    "/mappings/infer": {
      "get": {
        "summary": "Returns mappings based on stored mappings and mappings derived by inference",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-mappingsinfer"
        }
      }
    },
    "/mappings/apply": {
      "get": {
        "summary": "Apply mappings to a JSKOS set",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-mappingsapply"
        }
      },
      "post": {
        "summary": "Apply mappings to a JSKOS set",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#post-mappingsapply"
        }
      }
    },
    "/mappings/": {
      "get": {
        "summary": "Lists details of mappings",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-mappings"
        }
      }
    },
    "/mappings/{id}": {
      "get": {
        "summary": "Returns a mapping",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-mappings_id"
        }
      }
    },
    "/registries/": {
      "get": {
        "summary": "Lists details of registries",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-registries"
        }
      }
    },
    "/registries/suggest": {
      "get": {
        "summary": "Return search suggestions for registries",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-registriessuggest"
        }
      }
    },
    "/concepts": {
      "get": {
        "summary": "Lists details of concepts",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-concepts"
        }
      }
    },
    "/narrower": {
      "get": {
        "summary": "Returns narrower concepts of a concept",
        "deprecated": true,
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-narrower"
        }
      }
    },
    "/ancestors": {
      "get": {
        "summary": "Returns ancestor concepts of a concept",
        "deprecated": true,
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-ancestors"
        }
      }
    },
    "/suggest": {
      "get": {
        "summary": "Return search suggestions for concepts",
        "deprecated": true,
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-suggest"
        }
      }
    },
    "/search": {
      "get": {
        "summary": "Search for concepts",
        "deprecated": true,
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-search"
        }
      }
    },
    "/concepts/narrower": {
      "get": {
        "summary": "Returns narrower concepts of a concept",
        "deprecated": false,
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-conceptsnarrower"
        }
      }
    },
    "/concepts/ancestors": {
      "get": {
        "summary": "Returns ancestor concepts of a concept",
        "deprecated": false,
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-conceptsancestors"
        }
      }
    },
    "/concepts/suggest": {
      "get": {
        "summary": "Return search suggestions for concepts",
        "deprecated": false,
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-conceptssuggest"
        }
      }
    },
    "/concepts/search": {
      "get": {
        "summary": "Search for concepts",
        "deprecated": false,
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-conceptssearch"
        }
      }
    },
    "/data": {
      "get": {
        "summary": "Returns data for objects identified by their URI",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-data"
        }
      }
    },
    "/validate": {
      "get": {
        "summary": "Validate JSKOS objects",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#get-validate"
        }
      },
      "post": {
        "summary": "Validate JSKOS objects",
        "externalDocs": {
          "description": "documentation",
          "url": "https://github.com/gbv/jskos-server#post-validate"
        }
      }
    }
  },
  "externalDocs": {
    "description": "full documentation",
    "url": "https://github.com/gbv/jskos-server#readme"
  },
  "components": {
    "securitySchemes": {
      "bearerJWT": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "_locals": {}
}