## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://hub-docs.wundergraph.com/llms.txt)

Use this file to discover all available pages before exploring further.

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](https://cosmo-docs.wundergraph.com/studio/api-keys).

### 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