For Agents
Provision and manage Amazon Elasticsearch (OpenSearch) domains, packages, and cross-cluster connections through a single API.
Get started with Amazon Elasticsearch Service in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"create an Elasticsearch domain on AWS"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Amazon Elasticsearch Service API.
Create Elasticsearch and OpenSearch domains with custom instance counts, storage, and VPC settings
Manage service software updates and cancel pending update windows
Associate and dissociate packages such as custom dictionaries with running domains
Set up cross-cluster search by creating inbound and outbound connections between domains
GET STARTED
Use for: I need to create a three-node Elasticsearch domain in a VPC, Update the instance type of an existing domain, List all Elasticsearch domains in this account, Cancel a pending service software update
Not supported: Does not handle index operations, search queries, or document ingestion — use for Elasticsearch and OpenSearch domain configuration only.
Jentic publishes the only available OpenAPI document for Amazon Elasticsearch Service, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Amazon Elasticsearch Service, keeping it validated and agent-ready. The Amazon Elasticsearch (now OpenSearch) Configuration API creates and manages Elasticsearch domains, including instance configuration, storage, VPC settings, access policies, package associations, and cross-cluster connection setup. The API also covers service software updates, package management, and VPC endpoint authorisation. It is built for platform teams that need to provision and operate search and analytics clusters on AWS without console-driven workflows.
Authorize and revoke VPC endpoint access for cross-account domain consumers
Tag and untag domains, packages, and connections for cost allocation
Describe domain change progress to monitor configuration roll-outs
Patterns agents use Amazon Elasticsearch Service API for, with concrete tasks.
★ Search Domain Provisioning
Platform teams use the Amazon Elasticsearch API to provision search and log-analytics domains with VPC isolation, dedicated master nodes, and EBS storage. The API drives domain creation, configuration updates, and access policy management so that infrastructure pipelines can stand up search backends without console clicks. A typical three-node VPC domain provisions in fifteen to thirty minutes, returning a domain endpoint for application connection.
Create an Elasticsearch domain named search-prod with three r5.large.elasticsearch instances and 100 GiB of EBS storage in subnets subnet-a and subnet-b.
Cross-Cluster Search Setup
Data platform teams use cross-cluster connections to query indices that live in separate Elasticsearch domains, often for tenancy or region isolation. The API creates inbound and outbound connections, enabling federated queries without bulk data movement. This pattern keeps shard counts manageable per domain while preserving a single query surface for analysts.
Create an outbound cross-cluster connection from domain search-prod to remote domain search-eu and accept the matching inbound connection.
Service Software Update Coordination
Reliability teams use the API to monitor and time service software updates for Elasticsearch domains so that planned maintenance windows align with low-traffic periods. The API exposes start, schedule, and cancel actions for software updates and surfaces the engine version progress field so dashboards can track fleet-wide patch state. Coordinated updates limit availability impact on customer-facing search.
Cancel the pending service software update on domain search-prod and reschedule it for the next maintenance window.
Agent-Driven Search Cluster Operations via Jentic
AI agents use the Amazon Elasticsearch API through Jentic to manage domain lifecycle, package associations, and software updates as part of larger platform workflows. Jentic exposes Elasticsearch operations as discoverable tools so an agent can search by intent and execute the matching call. This lets a platform agent respond to capacity or version events without console interaction.
Search Jentic for create elasticsearch domain, load the CreateElasticsearchDomain schema, and execute it for a new staging domain with two t3.medium.elasticsearch nodes.
50 endpoints — jentic publishes the only available openapi specification for amazon elasticsearch service, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/2015-01-01/es/domain
Create a new Elasticsearch domain
/2015-01-01/packages
Create a custom package such as a synonym list
/2015-01-01/packages/associate/{PackageID}/{DomainName}
Associate a package with a domain
/2015-01-01/es/domain/{DomainName}/authorizeVpcEndpointAccess
Authorize VPC endpoint access
/2015-01-01/es/serviceSoftwareUpdate/cancel
Cancel a pending service software update
/2015-01-01/es/ccs/outboundConnection
Create an outbound cross-cluster connection
/2015-01-01/tags
Add tags to a domain or package
/2015-01-01/es/domain
Create a new Elasticsearch domain
/2015-01-01/packages
Create a custom package such as a synonym list
/2015-01-01/packages/associate/{PackageID}/{DomainName}
Associate a package with a domain
/2015-01-01/es/domain/{DomainName}/authorizeVpcEndpointAccess
Authorize VPC endpoint access
/2015-01-01/es/serviceSoftwareUpdate/cancel
Cancel a pending service software update
Three things that make agents converge on Jentic-routed access.
Credential isolation
AWS access keys for the Elasticsearch Configuration API are stored encrypted in the Jentic vault. Agents receive scoped, short-lived signing access — raw secret access keys never enter the agent context.
Intent-based discovery
Agents search by intent (for example create a search domain) and Jentic returns matching Elasticsearch operations with their input schemas, so the agent can call the right endpoint without browsing AWS docs.
Time to first call
Direct integration: 1-2 days for SigV4 signing, VPC config, and update polling. Through Jentic: under 30 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Amazon EC2
Manages the VPC subnets and security groups domains run inside
Choose EC2 when you need to inspect or modify the networking configuration that surrounds an Elasticsearch domain.
Amazon Kinesis Data Analytics
Streams data into Elasticsearch domains in near real time
Choose Kinesis Data Analytics when you need to transform streaming data before indexing into a search domain.
AWS Lambda
Custom indexing and processing functions in front of Elasticsearch
Choose Lambda when documents need transformation or enrichment before being indexed into a domain.
Specific to using Amazon Elasticsearch Service API through Jentic.
Why is there no official OpenAPI spec for Amazon Elasticsearch Service?
AWS does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Amazon Elasticsearch Service via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Amazon Elasticsearch API use?
The Configuration API uses AWS Signature Version 4 request signing. Through Jentic, AWS access keys are stored encrypted in the vault and signing happens server-side, so the agent never sees the raw secret access key.
Can I create OpenSearch domains with this API?
Yes. POST /2015-01-01/es/domain creates Elasticsearch and OpenSearch domains; the EngineVersion field accepts both Elasticsearch_7.x and OpenSearch_x.y values to select the engine.
What are the rate limits for the Amazon Elasticsearch API?
AWS applies per-account, per-region throttling on the Configuration API. Mutating calls such as CreateElasticsearchDomain are throttled more aggressively than describe calls. Use exponential backoff on ThrottlingException responses; AWS does not publish exact TPS numbers in the spec.
How do I associate a custom synonyms package with a domain through Jentic?
Search Jentic for associate elasticsearch package, load the schema for POST /2015-01-01/packages/associate/{PackageID}/{DomainName}, and execute it with the package ID and domain name. Jentic returns the association status.
Does this API run search queries against indices?
No. This is the configuration API for managing domains. Index and search requests go to the per-domain endpoint URL using the standard Elasticsearch or OpenSearch query DSL.
/2015-01-01/es/ccs/outboundConnection
Create an outbound cross-cluster connection
/2015-01-01/tags
Add tags to a domain or package