Install Jentic One Beta

Connect the APIMATIC API Transformer to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the APIMATIC API Transformer, 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fapimatic.io%2Fapimatic" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fapimatic.io%2Fapimatic" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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.

Capabilities

What an agent can do with APIMATIC API Transformer API.

Convert a Swagger 2.0 description into OpenAPI 3.0 in one POST /transform call

Translate a RAML 1.0 file to OpenAPI 3.0 for tooling that does not read RAML

Generate an OpenAPI description from a Postman Collection so it can be imported into spec-first tools

Output an APIMATIC-formatted description suitable for SDK generation downstream

GET STARTED

Start building with APIMATIC API Transformer API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use APIMATIC API Transformer API for, with concrete tasks.

★ Spec format normalisation in CI

Run POST /transform as a CI step so that pushing a single canonical description automatically produces alternative formats for downstream consumers. Teams can keep an OpenAPI 3.0 source of truth and emit Postman, RAML, or APIMATIC descriptions with one HTTP call per target. This avoids drift between the canonical spec and the formats published to partners or developers.

POST /transform with input_format=APIMATIC, output_format=OpenApi3Json, and the canonical APIMATIC file as the body.

Migrating from Swagger 2.0 to OpenAPI 3.0

Migrate legacy Swagger 2.0 files to OpenAPI 3.0 in bulk by scripting the /transform endpoint over a directory of specs. The conversion handles structural differences such as parameters, requestBody, and components so engineering teams do not need to rewrite every spec by hand. The output is a clean OpenAPI 3.0 document ready to lint, render, and host.

POST /transform with input_format=Swagger20, output_format=OpenApi3Json, and the legacy file body, then save the response as the new spec.

Generating Postman Collections from OpenAPI

Produce an up-to-date Postman Collection from an OpenAPI 3.0 source as part of every release so QA engineers always test against the latest contract. /transform accepts OpenApi3Json or OpenApi3Yaml as input and emits Postman_2.1 as output. The result can be imported into a shared Postman workspace or attached to a release artefact.

POST /transform with input_format=OpenApi3Json, output_format=Postman_2.1, and the current spec, then upload the resulting collection to Postman.

Agent-driven format conversion

An agent integrating with a partner that only accepts a specific description format can transform whatever the user provides into that format on the fly through Jentic. The conversion is one call, the credentials sit in your Jentic One instance, and the agent only needs to know which input and output formats are required. This removes a common friction point in agent-driven onboarding flows.

Through Jentic, search 'convert an API description format', load the apimatic.io /transform operation, and execute with input and output formats and the source file.

Key Endpoints

1 endpoints — apimatic api transformer is a single-endpoint service that converts api description files between formats such as openapi, swagger 2.

METHOD

PATH

DESCRIPTION

POST

/transform

Convert an API description from one format to another

POST

/transform

Convert an API description from one format to another

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the APIMATIC API Transformer by hand means setting up its API key or basic auth, packaging the source description, and handling the converted output yourself. Through Jentic you install once, import APIMATIC Transformer from the API Directory, store the credential once, and your agent calls it.

Permission scoping

The APIMATIC Transformer exposes a single transform operation that takes the source and target formats in the request, so scope the agent to that one operation. You choose the allowed operations, so the agent only calls what you list.

Credential isolation

Your APIMATIC credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'convert an API description to another format', and Jentic returns the matching APIMATIC Transformer operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using APIMATIC API Transformer API through Jentic.

What authentication does the APIMATIC API Transformer use?

The API supports two schemes: an apiKey credential and HTTP basic auth. Use whichever your APIMATIC plan provides. When called through Jentic, the chosen credential is held in your Jentic One instance and applied to the request server-side.

Which input and output formats does /transform support?

The Transformer covers OpenAPI 3.0 (JSON and YAML), Swagger 2.0, Swagger 1.x, RAML 0.8 and 1.0, API Blueprint, WSDL, Postman Collection 1.0/2.0/2.1, and APIMATIC's own format. Pass the input_format and output_format identifiers in the request and the source as the body.

Can I convert OpenAPI 3.0 into a Postman Collection?

Yes. POST /transform with input_format=OpenApi3Json (or OpenApi3Yaml) and output_format=Postman_2.1, and supply the source spec as the body. The response is a Postman Collection 2.1 file.

How do I run a format conversion through Jentic?

Search Jentic for 'convert an API description format', load the apimatic.io /transform operation, and execute with input_format, output_format, and the source spec contents. Jentic returns the converted description without exposing the API key to the agent.

What are the rate limits for the API Transformer?

Rate limits are not declared in the OpenAPI spec and depend on your APIMATIC plan tier. Treat HTTP 429 responses as a back-off signal and check the APIMATIC dashboard for current quotas.

Can I limit what my agent is allowed to do with the APIMATIC API Transformer?

Yes. The APIMATIC Transformer exposes a single POST /transform operation that converts a source description between formats, and because Jentic One runs self-hosted under your control, your own rules decide which operations and credentials the agent may use. Since there is only the one transform call, you can scope the agent to that operation alone, so it can convert specs but nothing else. The APIMATIC API key or basic credential stays in your Jentic One instance and is applied server-side, so the agent never sees it and can only invoke the operations you have listed.

APIMATIC API Transformer

Name: APIMATIC API Transformer API
Brand: APIMATIC API Transformer
Availability: InStock

Community OpenAPI document · agent-readyDeveloper ToolsPackage RegistryapiKey, basic1 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Convert an API description from one format to another (OpenAPI, Swagger 2.0, RAML, API Blueprint, WSDL, Postman Collection) through one /transform call.

Use for: Convert a Swagger 2.0 file to OpenAPI 3.0, Translate a Postman Collection into an OpenAPI spec, Turn a RAML description into OpenAPI 3.0 so I can host it on Stoplight, Generate an APIMATIC format description from my OpenAPI file

Not supported: Does not host specs, generate SDKs, or run linting - use for one-shot conversion between API description formats only.

APIMATIC API Transformer is a single-endpoint service that converts API description files between formats such as OpenAPI, Swagger 2.0, RAML, API Blueprint, WSDL, Postman Collection, and APIMATIC's own format. The /transform endpoint accepts an input format identifier and the source file body, then returns the converted description. It is widely used in CI pipelines that need to keep multiple API description formats in sync from one canonical source. Authentication is by APIMATIC API key in the request or by HTTP basic credentials.

Jentic One on Github View OpenAPI Document