Schema API Reference (v2.0 and above)¶

Introduction¶

The schema API provides the following features:

1. Execute SQL on the underlying Postgres database, supports schema modifying actions.

This is primarily intended to be used as an admin API to manage the Hasura schema.

Endpoint¶

All requests are POST requests to the /v2/query endpoint.

Request structure¶

POST /v1/query HTTP/1.1

{
   "type": "<query-type>",
   "args": <args-object>
}

Query

Request types¶

The various types of queries are listed in the following table:

Response structure¶

Request specific

{
    "path"  : String,
    "error" : String
}

{
    "error" : String
}

{
    "error" : String
}

Disabling schema API¶

Since this API can be used to make changes to the GraphQL schema, it can be disabled, especially in production deployments.

The enabled-apis flag or the HASURA_GRAPHQL_ENABLED_APIS env var can be used to enable/disable this API. By default, the schema/metadata 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.

# enable only graphql api, disable metadata and pgdump
--enabled-apis="graphql"
HASURA_GRAPHQL_ENABLED_APIS="graphql"

See GraphQL engine server flags reference for info on setting the above flag/env var.