Build with StructGen

Welcome to StructGen

StructGen is the AI-powered transformation layer for modern data stacks. Use StructGen to ingest files, normalize schemas, and deliver clean, validated Excel outputs ready for import into your systems.

Quick Start

Provision an API key, upload a file, and get a normalized output in minutes.

1. 1Sign in to the StructGen console and create a new workspace.
2. 2Generate an API key under Settings → API Keys.
3. 3Upload a sample file to inspect detected columns and types.

First Transform

Transform your first file using cURL:

The response includes a job_id and a download_url. Poll the status endpoint or register a webhook to receive completion events automatically.

API Keys

API keys are workspace-scoped and support role-based permissions. Rotate keys quarterly and restrict them to the minimum scopes needed for each integration.

• Production keys are labeled and require 2FA to create.
• Use environment variables to inject keys into CI/CD pipelines.
• Keys can be revoked instantly without downtime for existing jobs.

Schemas & Mapping

Define a target schema to normalize fields across source systems. StructGen learns from examples and suggests mappings that you can approve or override.

• Schema definitions support nested objects, arrays, and custom enum types.
• Map multiple input columns into a single output field with templates.
• Store mapping profiles per integration to reuse across datasets.

Validation Rules

Validation rules ensure output quality. Define required fields, data type constraints, and cross-field dependencies before export.

• Flag invalid records with structured error reasons.
• Apply normalization rules like phone or address formatting.
• Route invalid rows to a quarantine dataset for review.

Transform Plans

Transform plans bundle schemas, mappings, and validation into reusable workflows. Plans can be scheduled or triggered via API.

• Create versioned plans to support schema migrations.
• Attach enrichment steps like geocoding or deduplication.
• Enable incremental processing for large uploads.

Output & Integration

Transformed data is exported as clean Excel files. Download directly from the dashboard or retrieve via API for integration with your downstream systems.

• Download transformed Excel files per session.
• AI-normalized phone numbers in 10-digit format.
• Multi-sheet preservation from source files.

Authentication

All API requests use X-API-Key header authentication.

Endpoints

Core endpoints for the 6-phase transformation pipeline.

Errors

Errors use standard HTTP codes with structured JSON payloads. Capture the request_id for support.

Email Notifications

StructGen sends email notifications when transformations complete. Provide a user email when creating a session to receive automatic updates.

• Notification on transformation completion with row counts and file details.
• Direct link to download results from the dashboard.
• Non-blocking — failures are logged, never interrupt processing.

API Integration

Integrate with StructGen using the REST API. All endpoints accept JSON and return structured responses.

• Use cURL, Python requests, or any HTTP client.
• ZIP file uploads via multipart form data.
• Session-based workflow: create session → upload → analyze → transform → download.

Migration

Migrating from legacy ETL? Start by documenting your current schema, then map fields to StructGen targets and validate outputs in a staging workspace.

• Export mapping templates from the StructGen console.
• Run side-by-side comparisons on historical data.
• Promote the plan to production once validation is clean.

Release Notes

Track new features, deprecations, and API changes in the release feed inside the StructGen console. Subscribe to updates for weekly summary emails.

Support

Need help? Reach our support team via the in-app messenger or email