The REST API is accompanied by a Stoplight Elements served up at
/docs that lists out all of the endpoints, how to call them, and some inline descriptions of what they do. The UI even makes it possible to interactively try out endpoints by filling in text fields and clicking buttons.
For instance, on that page, in the Cypher Query Language section, you can click on the “issue a Cypher query” link to expand out the details for that API endpoint in the interactive panel. Now, you can see more details about this endpoint as well as try it out interactively by clicking on the Send API Request button.
This entire page is powered by a programmatically generated OpenAPI specification of our API (the raw version which is accessible at
/docs/openapi.json). This specification can also be used by users to programmatically generate client programs that call the API in the correct expected manner, see this page for more details about that.