Skip to main content

GraphQL Introduction

Powerful GraphQL API for flexible server management and real-time data querying
The Filed GraphQL API provides a flexible, efficient way to query and manage your taxpreps. Unlike REST APIs, GraphQL allows you to request exactly the data you need in a single request, reducing over-fetching and improving performance.

Key Features

  • Flexible Queries: Request only the data you need
  • Type Safety: Strongly typed schema with comprehensive documentation
  • Single Endpoint: All operations through one GraphQL endpoint

Getting Started

Endpoint

https://router.apps.filed.com/graphql

Authentication

All GraphQL requests require authentication using a Bearer token in the Authorization header.
Authorization: Bearer YOUR_JWT_ACCESS_TOKEN

Basic Query Example

query Health {
  health {
    id
    ai
    platform
  }
}

GraphQL desktop client

Explore the GraphQL API interactively using a desktop client:

GraphQL desktop client

Test queries with this desktop client (Httpie)

Benefits Over REST

Fetch multiple related resources in a single request instead of multiple REST calls.
Request only the fields you need, reducing payload size and improving performance.
Strongly typed schema prevents runtime errors and improves developer experience.

Next steps

Looking for the previous REST API? It is preserved under Legacy.