{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/pipeshub/json-schema/pipeshub-connector-type-schema.json",
  "title": "ConnectorType",
  "description": "A connector type from the registry. Represents an available integration\nthat can be configured as a connector instance.\n",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/pipeshub-connector-registry-api-openapi.yml#/components/schemas/ConnectorType",
  "type": "object",
  "properties": {
    "connectorType": {
      "type": "string",
      "description": "Unique identifier for this connector type"
    },
    "displayName": {
      "type": "string",
      "description": "Human-readable name"
    },
    "description": {
      "type": "string",
      "description": "What this connector does"
    },
    "appGroupId": {
      "type": "string",
      "description": "Application group identifier"
    },
    "appGroup": {
      "type": "string",
      "description": "Application group name (e.g., \"Google Workspace\")"
    },
    "authTypes": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ConnectorAuthType"
      },
      "description": "Supported authentication methods"
    },
    "supportedScopes": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ConnectorScope"
      },
      "description": "Supported scope types"
    },
    "supportsSync": {
      "type": "boolean",
      "description": "Whether connector supports data synchronization"
    },
    "supportsAgent": {
      "type": "boolean",
      "description": "Whether connector supports AI agent integration"
    },
    "supportsRealtime": {
      "type": "boolean",
      "description": "Whether connector supports real-time updates"
    },
    "iconPath": {
      "type": "string",
      "description": "Path to connector icon"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Categories (e.g., \"Storage\", \"Communication\")"
    },
    "isBeta": {
      "type": "boolean",
      "description": "Whether this is a beta connector"
    }
  },
  "$defs": {
    "ConnectorAuthType": {
      "type": "string",
      "description": "Authentication method required by the connector:<br>\n<ul>\n<li><code>OAUTH</code> - User OAuth consent flow</li>\n<li><code>OAUTH_ADMIN_CONSENT</code> - Admin OAuth with org-wide consent</li>\n<li><code>API_TOKEN</code> - API key or token authentication</li>\n<li><code>USERNAME_PASSWORD</code> - Username/password credentials</li>\n<li><code>NONE</code> - No authentication required</li>\n</ul>\n",
      "enum": [
        "OAUTH",
        "OAUTH_ADMIN_CONSENT",
        "API_TOKEN",
        "USERNAME_PASSWORD",
        "NONE"
      ]
    },
    "ConnectorScope": {
      "type": "string",
      "description": "Scope determines visibility and access control for connectors:<br>\n<ul>\n<li><code>team</code> - Available to all users in the organization (admin-only creation)</li>\n<li><code>personal</code> - Private to the creating user only</li>\n</ul>\n",
      "enum": [
        "team",
        "personal"
      ]
    }
  }
}