AWS Amazon Lex Model Building V2

Name: Amazon Lex Model Building V2 API
Brand: Amazon Lex Model Building V2
Availability: InStock

★ Only Publicly Available OpenAPI DocumentAI/MLLanguage Modelshmac71 Endpoints

Install Jentic One Beta

Connect the Amazon Lex Model Building V2 to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Amazon Lex Model Building V2, 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 | sh

Step 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 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 Amazon Lex Model Building V2 API.

Create and configure Amazon Lex V2 bots, including locales, intents, slots, slot types, and custom vocabulary entries

Build a bot locale to compile its NLU model and make it ready for runtime serving

Manage bot versions and aliases so a chat client can be pinned to a specific tested release

GET STARTED

Start building with Amazon Lex Model Building V2 API

Explore with Jentic

View OpenAPI Document

For Agents

Author and version Amazon Lex chatbots end-to-end - create bots, configure intents and slots, train locales, manage custom vocabulary, and publish via aliases.

Use for: Create a new Amazon Lex V2 bot for customer support, Build the en_US locale of bot id ABCD1234, Add a new intent BookFlight to a Lex bot locale, Upload a custom vocabulary list to bias slot recognition

Not supported: Does not handle runtime conversation, speech recognition inference, or message delivery - use for authoring, training, versioning, and tagging Lex V2 bots only.

Use Cases

Patterns agents use Amazon Lex Model Building V2 API for, with concrete tasks.

★ Author and Version a Conversational Bot End-to-End

Conversational AI teams need to define bots in code rather than the console. Lex Model Building V2 exposes the full authoring lifecycle as API calls - CreateBot, CreateBotLocale, CreateIntent, CreateSlotType, CreateSlot, BuildBotLocale and CreateBotVersion - so an agent can scaffold an entire conversational flow, train it, and pin a runtime alias to a tested version, all without touching the AWS console.

Call POST /bots/ with a bot name and IAM role, then POST /bots/{botId}/botversions/{botVersion}/botlocales/ with localeId=en_US, then POST a BuildBotLocale request and poll until status=Built

Promote Bots Between Environments via Import and Export

Promoting a Lex bot from development to staging to production benefits from a deterministic artefact rather than re-running create calls. The V2 model API supports CreateExport and CreateImport flows that package an entire bot definition as a ZIP archive, including locales, intents, slot types and custom vocabulary, and unpack it into a different account or region with role-scoped IAM credentials.

Call CreateExport for a botId+botVersion, poll until ExportStatus=Completed, download the ZIP, and call CreateImport in the target region with the same archive

Bias NLU Recognition With Domain-Specific Vocabulary

Domain-specific terms (drug names, product SKUs, regional spellings) are commonly mis-transcribed by generic NLU. Lex V2 supports custom vocabulary entries scoped per bot locale. An agent can batch-create or batch-update these entries from a CSV catalogue, rebuild the locale, and publish a new version - improving slot recognition accuracy for vertical use cases without retraining the underlying model.

Call /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary/DEFAULT/batchcreate with an array of phrases and weights, then trigger BuildBotLocale to apply

AI Agent Integration for Bot Authoring Pipelines

Through Jentic, an agent can drive the entire Lex V2 model-building flow - create bot, configure locales and intents, build, version and tag - by chaining intent searches against the catalogue. Jentic returns each step's input schema and brokers AWS credentials, so an LLM can stand up or modify a Lex bot from a single user instruction without scripting against boto3.

Resolve the intent 'create a Lex V2 bot' via Jentic search, load the CreateBot schema, and execute it with a bot name, role ARN, and idle session TTL

Key Endpoints

71 endpoints — jentic publishes the only available openapi specification for amazon lex model building v2, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/bots/

Create a new Lex V2 bot

POST

/bots/{botId}/botversions/{botVersion}/botlocales/

Create a locale on a bot version

POST

/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/

Create an intent in a bot locale

POST

/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary/DEFAULT/batchcreate

Batch-create custom vocabulary items

POST

/bots/{botId}/botaliases/

Create a bot alias pointing at a version

POST

/imports/

Import a bot from a ZIP archive

POST

/exports/

Export a bot version as a ZIP archive

POST

/bots/

Create a new Lex V2 bot

POST

/bots/{botId}/botversions/{botVersion}/botlocales/

Create a locale on a bot version

POST

/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/

Create an intent in a bot locale

POST

/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary/DEFAULT/batchcreate

Batch-create custom vocabulary items

POST

/bots/{botId}/botaliases/

Create a bot alias pointing at a version

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your AWS access keys are stored once, encrypted, by your own Jentic One instance and each request is signed with Signature Version 4 at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'create a Lex bot intent' or 'build a bot locale', and Jentic returns the matching Lex Model Building V2 operation with its input schema, so the agent calls CreateIntent or BuildBotLocale without browsing the reference docs.

Time to first call

FAQs

Specific to using Amazon Lex Model Building V2 API through Jentic.

Why is there no official OpenAPI spec for Amazon Lex Model Building V2?

AWS does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Amazon Lex Model Building V2 via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Amazon Lex V2 model API use?

The model-building API is signed with AWS Signature Version 4 using IAM access key/secret pairs. Through Jentic, those AWS credentials sit in your Jentic One instance and are used to sign each request on the agent's behalf so raw keys never enter the agent's context.

Can I create a complete chatbot through the Lex V2 API?

Yes. The API exposes the full authoring stack - CreateBot, CreateBotLocale, CreateIntent, CreateSlotType, CreateSlot, BuildBotLocale, CreateBotVersion and CreateBotAlias - so an agent can scaffold a bot, train its NLU, and publish a runtime alias entirely through API calls.

What are the rate limits for the Lex V2 model API?

AWS applies per-account and per-region throttling to the Lex control plane. Build operations are particularly slow and concurrency-limited, so design pipelines to poll DescribeBotLocale until status=Built rather than retrying tightly.

How do I train a bot locale through Jentic?

Use the Jentic search query 'build a Lex bot locale', load the operation behind /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/, and execute it with your botId, botVersion and localeId. Then poll DescribeBotLocale via Jentic until botLocaleStatus=Built before publishing a version.

How do I move a bot from one AWS account to another?

Use the Lex V2 export/import flow. Call CreateExport on the source botVersion, poll until ExportStatus=Completed, download the resulting ZIP, then call CreateImport in the target account with the same archive and a target bot name.

Can I limit what my agent is allowed to do with the Amazon Lex Model Building V2 API?

Yes. Because you run Jentic One yourself, your own rules decide which Lex V2 operations and AWS credentials the agent may use. Since the bot id lives in the URL path, you can pin the agent to a single bot so it may author intents, locales, and slots for that bot and nothing else. You choose the exact operations it can call, so destructive actions like deleting a bot are excluded unless you explicitly allow them.

AWS Amazon Lex Model Building V2

Connect the Amazon Lex Model Building V2 to your agent

Capabilities

Start building with Amazon Lex Model Building V2 API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs