Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Microcks API v1.7, 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%2Fmicrocks.local%2Fmicrocks" | shStep 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%2Fmicrocks.local%2Fmicrocks" | 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 Microcks API v1.7 API.
List, retrieve, and delete services and APIs registered in Microcks
Create, schedule, activate, start, and stop import jobs that ingest API artefacts
Upload artefacts directly via /artifact/upload for one-off imports
Trigger new contract tests, retrieve TestResults, and read messages or events for individual TestCases
GET STARTED
Manage secrets used by import jobs to fetch private artefacts
Override service operations and update service metadata or labels
Import and export Microcks snapshots for environment promotion
Patterns agents use Microcks API v1.7 API for, with concrete tasks.
★ Continuous Mock Refresh from Source Repos
Platform teams configure Microcks ImportJobs that periodically pull OpenAPI or AsyncAPI artefacts from a Git repository so that mocks always match the latest contract. The /jobs endpoints create and schedule the job, /jobs/{id}/start runs it on demand, and /artifact/upload covers the case where an artefact is staged from CI rather than pulled.
Create an ImportJob via POST /jobs pointing at the OpenAPI artefact URL, then PUT /jobs/{id}/start to run it immediately.
Contract Testing in CI Pipelines
QA and platform teams trigger Microcks tests from CI by calling POST /tests with a target service, version, and runner type, then poll GET /tests/{id} for results and use /tests/{id}/messages/{testCaseId} to retrieve the request/response samples for any failures. This produces evidence-rich contract test runs without leaving the pipeline.
Submit POST /tests for service ID 'svc_42' against the staging endpoint, poll GET /tests/{id} until completion, and return any failed TestCases.
Snapshot Promotion Across Environments
Teams promoting mock and test definitions across environments use POST /import and GET /export to move a Microcks snapshot from staging to production. Combined with /secrets management, the same import-export workflow works for environments that pull artefacts from private locations.
Call GET /export to capture the staging snapshot, then POST /import in production with the same payload.
Agent-Operated Mock Platform
An AI agent on a developer experience team can drive Microcks through Jentic - refreshing mocks after a contract change, kicking off tests, and surfacing failures in chat. The agent searches by intent, loads the right schema for /jobs, /tests, or /services, and executes with the JWT handled inside your Jentic One instance.
Search Jentic for 'run a contract test in Microcks', load POST /tests, and submit a test for the most recently imported service.
44 endpoints — microcks is the kubernetes-native open-source tool for api and microservices mocking and contract testing.
METHOD
PATH
DESCRIPTION
/services
List Services and APIs registered in Microcks
/jobs
Create an ImportJob
/jobs/{id}/start
Start an ImportJob immediately
/tests
Trigger a new contract test
/tests/{id}
Retrieve a TestResult
/artifact/upload
Upload an artefact directly
/import
Import a Microcks snapshot
/export
Export a Microcks snapshot
/services
List Services and APIs registered in Microcks
/jobs
Create an ImportJob
/jobs/{id}/start
Start an ImportJob immediately
/tests
Trigger a new contract test
/tests/{id}
Retrieve a TestResult
/artifact/upload
Upload an artefact directly
/import
Import a Microcks snapshot
/export
Export a Microcks snapshot
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Microcks by hand means running the Keycloak OAuth 2.0 flow for its jwt-bearer scheme, pointing at your own Microcks host, and setting the Authorization header yourself. Through Jentic you install once, import Microcks from the API Directory, store the client credentials once, and your agent calls it.
Permission scoping
Microcks puts jobs and tests by id in the URL path (/jobs/{id}/start, /tests/{id}), so a rule can pin your agent to specific resources. You choose the operations it may call, so starting import jobs or triggering an export is not included unless you add it.
Credential isolation
Your Microcks Keycloak credentials and issued JWTs are stored once, encrypted, by your own Jentic One instance and injected into the Authorization header at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'run a contract test' or 'create an import job', and Jentic returns the matching Microcks operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Microcks API v1.7 API through Jentic.
What authentication does the Microcks API use?
Microcks accepts OAuth 2.0 JWT tokens issued by its bundled Keycloak instance, configured via the GET /keycloak/config endpoint. Through Jentic the JWT is stored in the encrypted vault and added to the Authorization header at execution time.
Can I import a Postman collection as a service?
Yes - POST /artifact/upload accepts Postman collections alongside OpenAPI and AsyncAPI artefacts. For repeatable imports use POST /jobs with the artefact URL so Microcks pulls and refreshes it on a schedule.
What are the rate limits for the Microcks API?
Microcks itself does not enforce documented per-endpoint rate limits - limits are governed by the deployment topology and the Keycloak token policy. For high-frequency CI integrations, batch service queries through /services/search and reuse tokens.
How do I trigger a contract test through Jentic?
Search Jentic for 'run a Microcks test', load POST /tests, and submit the service ID, target endpoint, and runner type. Jentic adds the JWT from your stored credential and the agent polls GET /tests/{id} for completion.
Is Microcks free to use?
Yes - Microcks is open-source under Apache 2.0 and you self-host it. The API is part of the open-source distribution; commercial support is available from the Microcks team but is not required to use the API.
Can I override individual mock operations without re-importing?
Yes - PUT /services/{id}/operation lets you tweak a single operation's settings, and PUT /services/{id}/metadata updates labels and metadata without re-running the import job.
Can I limit what my agent is allowed to do with the Microcks API?
Yes. Because you self-host Jentic One, your own rules decide which Microcks operations the agent may call, so you can allow read-only calls like GET /services and GET /tests/{id} while withholding write actions such as POST /jobs, PUT /jobs/{id}/start, POST /tests, or POST /import. Since Microcks addresses jobs and tests by id in the URL path (/jobs/{id}/start, /tests/{id}), you can also pin the agent to specific resources rather than the whole platform. Nothing that starts an import job or triggers an export runs unless you have granted that operation.
For Agents
Manage mocked services, run import jobs, kick off contract tests, and inspect Microcks test results so agents can drive an internal mocking and testing platform.
Use for: I need to start an import job that pulls a fresh OpenAPI spec, Trigger a contract test against the staging deployment of my service, Get the latest TestResults for a specific service, Search for services by label or name
Not supported: Does not generate API specs, host production traffic, or perform performance or security testing - use for mocking, contract testing, and import lifecycle management only.
Microcks is the Kubernetes-native open-source tool for API and microservices mocking and contract testing. Its administrative API exposes endpoints to manage services and APIs, run import jobs against OpenAPI, AsyncAPI, and Postman artefacts, store secrets, and execute conformance tests with detailed test results. The 44-endpoint REST API is protected by Keycloak-issued JWTs and supports import, export, and snapshot workflows for CI integration.