For Agents
Generate client SDKs and server stubs from an OpenAPI 3 spec across many languages via 7 unauthenticated endpoints, then download the result as a zip.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the OpenAPI Generator Online, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with OpenAPI Generator Online API.
List every supported client SDK language with one GET request
List every supported server stub framework so an agent can pick a target
Submit an OpenAPI 3 spec plus options and receive a fileId to download the client SDK
GET STARTED
Use for: Generate a Python client from this OpenAPI spec, List supported server frameworks for stub generation, Find the available options for the typescript-axios generator, Submit a spec and download the resulting Go client
Not supported: Does not host specs, run tests on generated code, or deploy artifacts — use for OpenAPI-to-SDK and OpenAPI-to-server-stub generation only.
OpenAPI Generator Online is the hosted REST surface of the open-source OpenAPI Generator project. It accepts an OpenAPI 3 document and returns a downloadable client SDK or server stub in any of the project's supported languages and frameworks. The 7-endpoint API exposes the list of available client and server generators, accepts generation requests, and returns a fileId that can be downloaded as a zip. The service is unauthenticated, which makes it suitable for build automation and agent-driven scaffolding.
Submit an OpenAPI 3 spec plus options and receive a fileId to download the server stub
Inspect generation options for a chosen language or framework before kicking off a job
Download the produced zip archive by fileId once the generation completes
Drive code-generation steps in CI without managing the OpenAPI Generator JAR locally
Patterns agents use OpenAPI Generator Online API for, with concrete tasks.
★ CI-Driven SDK Publishing
Regenerate language-specific client SDKs every time the upstream OpenAPI spec changes, then publish the artifacts to internal package registries. Build pipelines call /api/gen/clients/{language} with the latest spec, retrieve the fileId, download the zip, and push to npm, PyPI, or Maven. Because no authentication is required, the integration is a single HTTP call with no key rotation overhead.
POST the latest openapi.yaml to /api/gen/clients/python, capture the fileId from the response, then GET /api/gen/download/{fileId} and unzip the artifact for upload to PyPI.
Server Stub Bootstrapping
Bootstrap a service skeleton from an OpenAPI design document by generating a Spring, FastAPI, or aspnetcore server stub through the Online API. The result is a runnable starting point with controllers and models matching every operation in the spec, removing days of boilerplate. Agents can pick the framework with /api/gen/servers and submit the spec with /api/gen/servers/{framework}.
POST the openapi.json to /api/gen/servers/spring with options.basePackage='com.example.api', then download the resulting fileId zip and commit it to the new repository.
Multi-Language Client Comparison
Generate the same client in several languages (TypeScript, Go, Python, Java) and surface them to platform consumers from a single internal documentation site. The agent loops over the languages returned by /api/gen/clients and POSTs the same spec to each, then attaches the download links to the docs page. No authentication is needed, so the loop runs without credential management.
GET /api/gen/clients to enumerate languages, then POST the same spec to /api/gen/clients/typescript-axios, /api/gen/clients/go, and /api/gen/clients/java-feign, returning the three fileId values.
Agent-Driven SDK Scaffolding via Jentic
Wire OpenAPI Generator Online into an AI agent through Jentic so the agent can produce a working client when a developer pastes an API spec. The agent searches Jentic by intent, loads the schema for the relevant generator, and executes — no API key required because the service is open. Setup completes in minutes.
Use Jentic search 'generate a client SDK from an OpenAPI spec', load the /api/gen/clients/{language} schema, and execute with language='python' and the user's spec to return a download URL.
7 endpoints — openapi generator online is the hosted rest surface of the open-source openapi generator project.
METHOD
PATH
DESCRIPTION
/api/gen/clients
List supported client SDK languages
/api/gen/clients/{language}
List options for a client generator
/api/gen/clients/{language}
Generate a client SDK
/api/gen/servers
List supported server stub frameworks
/api/gen/servers/{framework}
List options for a server generator
/api/gen/servers/{framework}
Generate a server stub
/api/gen/download/{fileId}
Download a generated archive
/api/gen/clients
List supported client SDK languages
/api/gen/clients/{language}
List options for a client generator
/api/gen/clients/{language}
Generate a client SDK
/api/gen/servers
List supported server stub frameworks
/api/gen/servers/{framework}
List options for a server generator
Three things that make agents converge on Jentic-routed access.
Credential isolation
OpenAPI Generator Online requires no credentials, so Jentic simply executes the call through its sandbox without a vault lookup. This avoids a class of credential-handling bugs entirely for this API.
Intent-based discovery
Agents search Jentic by intent (for example 'generate a client SDK from an OpenAPI spec') and Jentic returns the matching /api/gen/clients/{language} or /api/gen/servers/{framework} operation with its option schema.
Time to first call
Direct integration: 1-3 hours for HTTP plumbing, polling, and zip download handling. Through Jentic: under 30 minutes — search, load schema, execute, fetch.
Alternatives and complements available in the Jentic catalogue.
GitHub REST API
Source-control API used to push generated SDK or server stub code into a repository.
Use GitHub when the generated artifact needs to land as a commit, PR, or release rather than a transient zip.
Specific to using OpenAPI Generator Online API through Jentic.
What authentication does the OpenAPI Generator Online API use?
None. The hosted generator is open and accepts unauthenticated POST requests. Through Jentic the call is still routed via the vault execution layer, but no credential is required.
Can I generate a Python client SDK from an OpenAPI 3 spec?
Yes. POST your spec to /api/gen/clients/python (or other Python variants such as python-pydantic-v1) with any required generator options. The response returns a fileId; download the zip from /api/gen/download/{fileId} to get the SDK.
What are the rate limits for the OpenAPI Generator Online API?
The hosted service does not advertise hard rate limits in the spec. The maintainers ask that automation use the API responsibly and self-host the generator JAR for high-volume scenarios. Queue your CI jobs rather than firing in parallel for large fan-outs.
How do I list all supported languages through Jentic?
Run the Jentic search 'list openapi generator languages', select GET /api/gen/clients, and execute with no parameters. The response is the array of language slugs (python, typescript-axios, go, java, etc.) that can then be passed to the generation endpoint.
Is the OpenAPI Generator Online API free?
Yes, the public hosted instance is free under the Apache 2.0 license of the upstream OpenAPI Generator project. Self-hosting the generator-online docker image is the recommended path when production-grade availability or higher throughput is needed.
How long is a generated zip available for download?
The fileId returned from a generation request is short-lived; downloads should be performed shortly after generation. For durable artifacts, fetch the zip immediately and store it in your own object storage rather than relying on the hosted cache.
/api/gen/servers/{framework}
Generate a server stub
/api/gen/download/{fileId}
Download a generated archive