mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-12-25 00:13:11 +03:00
b2461c5899
Co-authored-by: Toan Nguyen <hgiasac@gmail.com> Co-authored-by: Vamshi Surabhi <0x777@users.noreply.github.com>
75 lines
1.5 KiB
ReStructuredText
75 lines
1.5 KiB
ReStructuredText
.. meta::
|
|
:description: Hasura config API reference
|
|
:keywords: hasura, docs, config API, API reference
|
|
|
|
.. _config_api_reference:
|
|
|
|
Config API Reference
|
|
====================
|
|
|
|
.. contents:: Table of contents
|
|
:backlinks: none
|
|
:depth: 1
|
|
:local:
|
|
|
|
The Config API is an admin only endpoint which gives info on the server
|
|
configuration.
|
|
|
|
Endpoint
|
|
--------
|
|
|
|
All requests are ``GET`` requests to the ``/v1alpha1/config`` endpoint.
|
|
|
|
API Spec
|
|
--------
|
|
|
|
Request
|
|
^^^^^^^
|
|
|
|
.. code-block:: http
|
|
|
|
GET /v1alpha1/config HTTP/1.1
|
|
X-Hasura-Role: admin
|
|
|
|
|
|
|
|
Sample response
|
|
^^^^^^^^^^^^^^^
|
|
|
|
.. code-block:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"version": "v1.0.0-beta.3",
|
|
"is_admin_secret_set": true,
|
|
"is_auth_hook_set": false,
|
|
"is_jwt_set": true,
|
|
"jwt": {
|
|
"claims_namespace": "https://hasura.io/jwt/claims",
|
|
"claims_format": "json"
|
|
},
|
|
"is_allow_list_enabled": false,
|
|
"live_queries": {
|
|
"batch_size": 100,
|
|
"refetch_delay": 1
|
|
}
|
|
}
|
|
|
|
Disabling Config API
|
|
--------------------
|
|
|
|
The ``enabled-apis`` flag or the ``HASURA_GRAPHQL_ENABLED_APIS`` env var can be
|
|
used to enable/disable this API. By default, this API is enabled. To disable it,
|
|
you need to explicitly state that this API is not enabled. i.e. remove it from
|
|
the list of enabled APIs.
|
|
|
|
.. code-block:: bash
|
|
|
|
# enable only graphql & metadata apis, disable config
|
|
--enabled-apis="graphql,metadata"
|
|
HASURA_GRAPHQL_ENABLED_APIS="graphql,metadata"
|
|
|
|
See :ref:`server_flag_reference` for info on setting the above flag/env var.
|