Schema & Tooling | Moloni ON API
Moloni ONGuidesAPI ReferenceExplorer
Guides

Schema & Tooling

The Moloni ON API publishes its GraphQL schema as a machine-readable file you can point developer tools at: IDEs, code generators, HTTP clients, and AI assistants.

GraphQL Schema

The full GraphQL introspection schema is available at:

https://api.molonion.pt/schema.json

This is the standard GraphQL introspection result, containing every type, field, argument, and description in the API, in a format understood by virtually all GraphQL tooling.

VS Code

Install the GraphQL Language Feature Support extension, then create a graphql.config.yml at the root of your project:

schema: https://api.molonion.pt/schema.json

You'll get autocomplete, go-to-definition, type checking, and inline documentation on all types and fields inside .graphql files, without hitting the live API.

Code Generation with graphql-codegen

GraphQL Code Generator can produce TypeScript types, typed operation hooks, mock data, and more:

# codegen.yml
schema: https://api.molonion.pt/schema.json
documents: src/**/*.graphql
generates:
  src/generated/moloni.ts:
    plugins:
      - typescript
      - typescript-operations

npx graphql-codegen

Insomnia, Postman, and Altair

All three support loading a GraphQL schema from a URL in the collection settings. Point them at https://api.molonion.pt/schema.json to get autocomplete and field documentation in the query editor without needing to run an introspection query against the live API.

SDL Schema

The schema in GraphQL SDL (Schema Definition Language) format is available at:

https://api.molonion.pt/schema.graphql

This is the human-readable .graphql text format, useful for auditing the schema, diffing changes between versions, or loading into tools that prefer SDL over the JSON introspection format.

Next steps