It seems like the REST API docs are outdated? I am looking at the docs located at https://docs.oracle.com/cd/E56133_01/1.2.0/rest/resource_FutureEndpoint.html and noticed that by judging the API calls the PGX Java client library makes (currently using 2.4.1), it seems like some of the paths don't match up.
For example, the API docs documents the /future endpoint with the following, but it seems like /future/core is a new accessible route that isn't documented. Another example is the /core endpoint, where it seems like the library is making a POST-based call to /core/graph to create a graph when in the documentation, it suggests POST-ing at /core/session/{sessionId}/graph to create a graph:
Also, trying to understand and determine the kind of JSON requests that should be made at certain paths and the expected JSON responses is quite hairy considering that the request and response schemas are in verbose XML. Are there currently any plans in improving the REST API docs so that clients can be made for other languages besides NodeJS and Java?