Skip to main content

​
midPilot Connector Generator

Automatically generate midPoint identity connectors from any REST or SCIM API documentation using AI

​
What is midPilot Connector Generator?

The midPilot Connector Generator is an intelligent microservice that automates the process of creating midPoint identity management connectors. Instead of manually writing connector code, you provide API documentation and let the AI extract schemas, generate code, and build production-ready connectors.

​
Key Features

AI-Powered Generation

Leverages large language models to understand API documentation and generate accurate connector code

Automated Discovery

Automatically discovers and scrapes relevant API documentation from provided URLs

Schema Extraction

Intelligently extracts object classes, attributes, endpoints, and relationships from documentation

Session-Based Workflow

Organize your work into sessions with full state persistence and resumable operations

REST & SCIM Support

Supports both REST APIs and SCIM protocol with automatic protocol detection

Groovy Code Output

Generates production-ready Groovy connector code compatible with midPoint

Job Tracking

Monitor progress with detailed job status and stage information

Database Persistence

PostgreSQL-backed storage ensures your work is never lost

​
How It Works

The connector generation process follows a structured workflow:
1

Create a Session

Start by creating a new session to organize your connector generation work
2

Discover Documentation

Provide the target application name or URLs, and the service discovers relevant API documentation
3

Scrape Content

The scraper fetches and processes documentation pages, filtering out irrelevant content
4

Extract Schema

AI analyzes the documentation to extract object classes, attributes, API endpoints, authentication methods, and relationships
5

Generate Code

Based on extracted schemas, the service generates Groovy connector code including native schemas, ConnID mappings, and CRUD operations
6

Download & Deploy

Retrieve the generated code and deploy it to your midPoint instance

​
Architecture

The service is built with FastAPI and organized into four core modules:
  • Discovery - Finds candidate documentation URLs using search engines
  • Scrape - Fetches and filters relevant documentation content
  • Digester - Extracts structured information using AI
  • CodeGen - Generates Groovy connector code from extracted schemas
All operations are asynchronous with job tracking, allowing you to monitor long-running tasks and resume work later.

​
Use Cases

Quickly generate a working connector prototype from API docs to validate integration feasibility before investing in manual development.
Connect legacy systems with poor or incomplete documentation by letting AI infer schemas and patterns from available docs.
Accelerate onboarding of new SaaS applications by automatically generating connectors from their public API documentation.
When APIs change, regenerate connector code to quickly update schemas and endpoints while preserving custom business logic.

​
Getting Started

Ready to generate your first connector? Head over to the Quickstart guide to set up the service and create your first connector in minutes.

Quickstart

Get up and running in 5 minutes

Architecture

Learn how the system works

API Reference

Explore the REST API

Configuration

Configure the service

Build docs developers (and LLMs) love

Get started for freeTalk to us