For Agents
Search a 7,000+ API catalogue by intent, load operation schemas, and execute calls — plus manage agent identities, vaulted credentials, sandboxes, and workflow runs.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Jentic API, 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 Jentic API.
Search the public API registry by natural-language intent and receive ranked operation matches
Load operation and workflow schemas on demand so agents can call them without scraping vendor docs
Execute API calls and Arazzo workflows through Jentic-managed sandboxes via Workflow Executions
GET STARTED
Use for: Search Jentic for an API that can send transactional emails, Load the schema for a specific Stripe payment operation, Execute a Jentic workflow that creates a CRM contact, Validate my Jentic agent API key
Not supported: Does not host vendor data or replace vendor APIs — use for agent identity, credential vaulting, intent search, and sandboxed execution that fronts other APIs only.
The Jentic API is the control plane for the Jentic platform: it lets agents and developers search the public API catalogue by intent, load operation schemas, and execute calls against any registered API through a single uniform surface. The 95 endpoints cover agent registration, credential vaulting, sandboxed execution, workflow runs, spec ingestion and validation, registry browsing, search, file uploads, and usage statistics. Authentication supports both bearer tokens (OAuth) and a personal agent API key (ak_*) sent in the Authorization header.
Provision and validate agent identities and personal API keys via the Agents endpoints
Grant, list, and revoke vaulted credentials per agent so secrets never reach the model context
Ingest new OpenAPI and Arazzo specs into the registry through the Ingest endpoints
Read usage statistics and audit per-agent activity via the Stats endpoints
Patterns agents use Jentic API for, with concrete tasks.
★ Intent-Based API Discovery for Agents
Agents that need to perform a real-world task (send an email, create a ticket, charge a card) call Jentic search with the natural-language intent and receive ranked API operations with their input schemas. This replaces the 'tell the model about every tool' pattern with on-demand discovery, keeping context windows small and tool catalogues fresh as the registry grows.
POST a search query 'send a transactional email' to the Search endpoint and select the top-ranked operation by score for execution.
Vaulted Credential Management
Production agents need API keys for many vendors without those keys ever entering the LLM context. The Credentials endpoints let an operator vault Stripe, SendGrid, HubSpot, and other secrets per agent, scoped per operation. At execution time Jentic injects the credential into the outbound call so the model only ever sees opaque references.
POST to the agent credential grant endpoint to attach a stripe-test credential to agent_123, then call execute and verify the credential is referenced by id rather than value.
Sandboxed Workflow Execution
Multi-step Arazzo workflows run inside Jentic sandboxes that handle pagination, retries, and rate-limit backoff. A single workflow execution can chain calls across vendors (e.g. create a Stripe customer, log a HubSpot contact, send a SendGrid welcome) without the agent owning any of the intermediate state, and the Workflow Executions endpoints expose status, logs, and outputs.
POST to the workflow execution endpoint with workflow_id=onboard-customer and inputs={email, name}, then poll the status endpoint until completed and return the workflow outputs.
Catalogue Contribution via Spec Ingestion
Vendors and contributors add new APIs to the catalogue by ingesting an OpenAPI document through the Ingest endpoints. Jentic validates, scores, and registers the spec so it becomes immediately searchable by every connected agent. Useful for partners who want their API to be discoverable to the agent ecosystem without joining each individual MCP host.
POST a candidate OpenAPI document to the Ingest endpoint and read the validation diagnostics from the response to confirm successful registration.
AI Agent Integration via Jentic
Jentic itself is the agent integration. Agents start by validating their api key against /api/v1/agents/validate-key, then issue search and execute calls for any downstream vendor. Sign up at https://app.jentic.com/sign-up to get an ak_* personal agent key.
Run pip install jentic, set JENTIC_AGENT_API_KEY=ak_..., and call validate-key to confirm the agent identity, then issue a search to confirm catalogue access.
95 endpoints — the jentic api is the control plane for the jentic platform: it lets agents and developers search the public api catalogue by intent, load operation schemas, and execute calls against any registered api through a single uniform surface.
METHOD
PATH
DESCRIPTION
/api/v1/agents/validate-key
Validate an agent's API key
/api/v1/agents/grant-credential
Attach a vaulted credential to an agent
/api/v1/agents/{agent_id}/credentials
List credentials attached to an agent
/api/v1/agents/{agent_id}/regenerate-key
Rotate an agent API key
/api/v1/agents/validate-key
Validate an agent's API key
/api/v1/agents/grant-credential
Attach a vaulted credential to an agent
/api/v1/agents/{agent_id}/credentials
List credentials attached to an agent
/api/v1/agents/{agent_id}/regenerate-key
Rotate an agent API key
Three things that make agents converge on Jentic-routed access.
Credential isolation
Jentic agent keys (ak_*) are scoped to a single agent identity. Vaulted vendor credentials are attached per-agent and injected at execute time so an LLM never sees raw Stripe/SendGrid/etc. secrets in its prompt.
Intent-based discovery
The Search endpoint is the discovery method itself — agents call it with natural language and receive ranked operation matches across the entire registered catalogue.
Time to first call
Building your own agent control plane: weeks. Adopting Jentic: minutes — install the SDK, set JENTIC_AGENT_API_KEY, and start searching.
Alternatives and complements available in the Jentic catalogue.
Specific to using Jentic API through Jentic.
What authentication does the Jentic API use?
Two schemes: a Bearer token for OAuth-style sessions and a personal agent API key (format ak_*) sent via the X-API-Key header (modeled as APIKeyHeader in the spec). For agent integrations, the api key is the typical choice and is set via the JENTIC_AGENT_API_KEY environment variable.
Can I search for API operations by natural-language intent with the Jentic API?
Yes — the Search endpoints accept a natural-language query and return ranked matches with their operation schemas. This is the primary discovery mechanism agents use to pick a tool at runtime instead of being preloaded with thousands of tool definitions.
What are the rate limits for the Jentic API?
Per-agent rate limits are documented at docs.jentic.com and are tied to the plan attached to your ak_* key. Free-tier keys have lower per-minute search and execute quotas than paid plans; check the Stats endpoint to see your current usage.
How do I grant a vendor credential to my agent through Jentic?
Run pip install jentic, set JENTIC_AGENT_API_KEY, then POST to /api/v1/agents/grant-credential with the agent_id and the credential reference. After that, search and execute calls for that vendor will inject the credential automatically — the raw secret is never returned to the agent.
Can I register my own API in the Jentic catalogue?
Yes — POST your OpenAPI document to the Ingest endpoints. Jentic validates it, scores its agent-readiness, and adds it to the searchable registry. New specs are typically discoverable to agents within minutes of successful ingestion.
Is the Jentic API free?
Yes for the free tier, which covers most individual-developer usage. Paid plans add higher rate limits, more vaulted credentials, and team management. Sign up at https://app.jentic.com/sign-up to get an ak_* key.