Skip to main content
Connect your graph to WunderGraph Cosmo to synchronize schema definitions and manage federated graphs.

​
Setup and Configuration

​
Step 1: Access Integration Settings

  1. Navigate to your graph in the dashboard
  2. Go to the Settings section
  3. Click on Integrations
  4. Select Schema Registry integration

​
Step 2: Choose Your Platform

Select WunderGraph Cosmo from the dropdown.

​
WunderGraph Cosmo Integration

​
Prerequisites

  • Active WunderGraph Cosmo account
  • API key with appropriate permissions
  • Access to your Cosmo studio

​
Step 3: Generate Cosmo API Token

To learn how to generate an API key, click here.

​
Step 4: Configure Cosmo Integration

  1. Select Platform: Choose “WunderGraph Cosmo” from the dropdown
  2. Enter API Token: Paste your Cosmo API token
  3. Choose Integration Mode: Select either “Select Graph” or “Create Graph”

​
Option A: Select Existing Graph

If you want to connect to an existing Cosmo graph:
  1. Select Graph Tab: Click on “Select Graph”
  2. Choose Graph: Select from available graphs organized by namespace
    • Graphs are grouped by their namespace (e.g., default, production)
  3. Save Configuration: Click “Save” to complete the integration

​
Option B: Create New Graph

If you want to create a new federated graph in Cosmo:
  1. Create Graph Tab: Click on “Create Graph”
  2. Graph Name: Enter a unique name for your new graph
  3. Namespace: Select the target namespace from available options
  4. Routing URL: Enter the URL where the router will be accessible
    • Example: https://api.example.com/graphql
  5. Label Matchers (Optional): Add label matchers for subgraph selection
    • Format: key=value pairs
    • Press Enter or Space to add each matcher
    • Example: env=production, team=backend
  6. Save Configuration: Click “Save” to create and connect the graph