Metadata API Reference: Custom Types

Table of contents

Introduction

Custom Types are user-defined GraphQL types which help to define Actions.

Supported from

The metadata API is supported for versions v2.0.0 and above and replaces the older schema/metadata API.

set_custom_types

set_custom_types is used to set user-defined GraphQL types. This API will replace the given types with existing ones.

POST /v1/metadata HTTP/1.1
Content-Type: application/json
X-Hasura-Role: admin

{
  "type": "set_custom_types",
  "args": {
    "scalars": [],
    "enums": [],
    "input_objects": [
      {
        "name": "User",
        "fields": [
          {
            "name": "username",
            "type": "String!"
          },
          {
            "name": "password",
            "type": "String!"
          }
        ]
      }
    ],
    "objects": [
      {
        "name": "UserId",
        "fields": [
          {
            "name": "id",
            "type": "Int!"
          }
        ],
        "relationships": [
          {
            "name": "posts",
            "type": "array",
            "remote_table": "post",
            "field_mapping": {
              "id": "user_id"
            }
          }
        ]
      }
    ]
  }
}

Args syntax

Key Required Schema Description
input_objects false Array of InputObjectType Set of GraphQL Input Object
objects false Array of ObjectType Set of GraphQL Object
scalars false Array of ScalarType Set of GraphQL Scalar
enums false Array of EnumType Set of GraphQL Enum