Connecting to GraphQL Reference Guide
TerminusDB hosts a GraphQL endpoint at:
For instance, with a data product named
admin/people, and a locally installed TerminusDB, you can query it at:
For TerminusCMS you can use the following URL:
ORG is your organization, and
DATA_PRODUCT is the name of your data product.
Since TerminusDB requires authentication to access data products, you will need to use the authentication method that has been configured for your server.
Using Basic Auth, the default method in locally installed TerminusDBs, you can supply the Authorization header, with your basic auth. (To generate a Basic Auth string, see Basic Auth Generator).
For example, if you would like to connect to
admin/people with the apollo client to download the associated GraphQL schema, simply use:
npx apollo client:download-schema --endpoint=http://127.0.0.1:6363/api/graphql/admin/people schema.graphql --header='Authorization: Basic YWRtaW46cm9vdA=='
In TerminusCMS you can use an API key with the following header.
For instance, with the apollo client, you can download your schema as follows:
npx apollo client:download-schema --endpoint=https://cloud.terminusdb.com/TEAM/api/graphql/TEAM/people schema.graphql --header="Authorization: Token $(cat ~/my_token_file)"
my_token_file contains an API token for TerminusCMS.
TerminusDB ships with a GraphiQL graphical GraphQL query interface and schema browser. This is a quick way to get acquainted with GraphQL in TerminusDB.
You can reach this browser at:
You will also need to set your Authorization header in the Header dialog box at the bottom center.
For instance, in the default install, as:
"Authorization": "Basic YWRtaW46cm9vdA=="