Connector Catalog & Dynamic Forms

User selects connector → Platform fetches JSON Schema spec from Airbyte
  → Frontend renders typed form with groups, validation, and conditional fields
    → User fills form → Platform validates against spec → Source created

GET /api/v1/connectors/catalog

[
  {
    "sourceDefinitionId": "decd338e-5647-4c0b-adf4-da0e75f5a750",
    "name": "Postgres",
    "dockerRepository": "airbyte/source-postgres",
    "dockerImageTag": "3.7.2",
    "documentationUrl": "https://docs.airbyte.com/integrations/sources/postgres",
    "icon": "postgresql.svg",
    "releaseStage": "generally_available",
    "supportLevel": "certified",
    "matihCapabilities": {
      "supportsCDC": true,
      "supportsIncremental": true,
      "hasMCPServer": true,
      "availableModes": ["ingest", "live"]
    }
  }
]

GET /api/v1/connectors/postgres/spec

{
  "type": "object",
  "required": ["host", "port", "database", "username"],
  "properties": {
    "host": {
      "type": "string",
      "title": "Host",
      "description": "Hostname of the database.",
      "order": 0,
      "group": "db"
    },
    "port": {
      "type": "integer",
      "title": "Port",
      "default": 5432,
      "minimum": 0,
      "maximum": 65536,
      "order": 1,
      "group": "db"
    },
    "password": {
      "type": "string",
      "title": "Password",
      "airbyte_secret": true,
      "order": 5,
      "group": "auth"
    },
    "replication_method": {
      "type": "object",
      "title": "Update Method",
      "display_type": "radio",
      "oneOf": [
        {
          "title": "CDC (Write-Ahead Log)",
          "properties": {
            "method": {"const": "CDC"},
            "replication_slot": {"type": "string"},
            "publication": {"type": "string"}
          }
        },
        {
          "title": "Xmin System Column",
          "properties": {
            "method": {"const": "Xmin"}
          }
        }
      ]
    }
  },
  "groups": [
    {"id": "db"},
    {"id": "auth"},
    {"id": "security", "title": "Security"},
    {"id": "advanced", "title": "Advanced"}
  ]
}

POST /api/v1/connectors/postgres/validate
{
  "host": "db.example.com",
  "port": "not-a-number",
  "database": "mydb"
}

{
  "connectorType": "postgres",
  "valid": false,
  "errors": [
    "Port must be an integer (got: not-a-number)",
    "Missing required field: Username"
  ]
}