WunderGraph · Schema

WunderGraph Cosmo Subgraph

A Subgraph is an isolated GraphQL schema that can be independently deployed and managed, composing into federated graphs via label matching.

FederationGraphQLManagementSchema RegistryAPI GatewayObservabilityAgentsDeveloper Tools

Properties

Name Type Description
id string Unique identifier for the subgraph.
name string The name of the subgraph.
namespace string The namespace the subgraph belongs to.
routingUrl string The URL where the subgraph service is hosted.
labels array Labels attached to the subgraph for matching to federated graphs.
subscriptionUrl string URL for WebSocket-based GraphQL subscriptions if different from the routing URL.
subscriptionProtocol string The subscription transport protocol.
lastPublishedAt string When the schema was last published.
readme string Readme description of the subgraph.
createdAt string When the subgraph was created.
updatedAt string When the subgraph was last updated.
View JSON Schema on GitHub

JSON Schema

subgraph.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/api-evangelist/wundergraph/blob/main/json-schema/subgraph.json",
  "title": "WunderGraph Cosmo Subgraph",
  "description": "A Subgraph is an isolated GraphQL schema that can be independently deployed and managed, composing into federated graphs via label matching.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the subgraph."
    },
    "name": {
      "type": "string",
      "description": "The name of the subgraph."
    },
    "namespace": {
      "type": "string",
      "description": "The namespace the subgraph belongs to."
    },
    "routingUrl": {
      "type": "string",
      "format": "uri",
      "description": "The URL where the subgraph service is hosted."
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "description": "Labels attached to the subgraph for matching to federated graphs."
    },
    "subscriptionUrl": {
      "type": "string",
      "format": "uri",
      "description": "URL for WebSocket-based GraphQL subscriptions if different from the routing URL."
    },
    "subscriptionProtocol": {
      "type": "string",
      "enum": ["ws", "sse", "sse_post"],
      "description": "The subscription transport protocol."
    },
    "lastPublishedAt": {
      "type": "string",
      "format": "date-time",
      "description": "When the schema was last published."
    },
    "readme": {
      "type": "string",
      "description": "Readme description of the subgraph."
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "When the subgraph was created."
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "When the subgraph was last updated."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/subgraph"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.