# Amazon Lex Runtime V2 API

> Amazon Lex Runtime V2 API on Apizie: 5 endpoints (Returns session information for a specified bot, alias, and user. For example, you can use this operation to…, Creates a new session or modifies an existing session with an Amazon Lex V2 bot. Use this operation to…, Removes session information for a specified bot, alias, and user ID. You can use this operation to restart a…, Sends user input to Amazon Lex V2. Client applications use this API to send requests to Amazon Lex V2 at…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-runtime-lex-v2/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-runtime-lex-v2`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-runtime-lex-v2
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-runtime-lex-v2/openapi.json

This section contains documentation for the Amazon Lex V2 Runtime V2 API operations.

## Endpoints

### Returns session information for a specified bot, alias, and user. For example, you can use this operation to…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-runtime-lex-v2/get-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| botId | string | yes | The identifier of the bot that contains the session data. |
| botAliasId | string | yes | The alias identifier in use for the bot that contains the session data. |
| localeId | string | yes | The locale where the session is in use. |
| sessionId | string | yes | The identifier of the session to return. |

### Creates a new session or modifies an existing session with an Amazon Lex V2 bot. Use this operation to…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-runtime-lex-v2/put-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| botId | string | yes | The identifier of the bot that receives the session data. |
| botAliasId | string | yes | The alias identifier of the bot that receives the session data. |
| localeId | string | yes | The locale where the session is in use. |
| sessionId | string | yes | The identifier of the session that receives the session data. |
| ResponseContentType | string | no | The message that Amazon Lex V2 returns in the response can be either text or speech depending on the value of this parameter. If the value… |
| body | object | yes | JSON request body |

### Removes session information for a specified bot, alias, and user ID. You can use this operation to restart a…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-runtime-lex-v2/delete-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| botId | string | yes | The identifier of the bot that contains the session data. |
| botAliasId | string | yes | The alias identifier in use for the bot that contains the session data. |
| localeId | string | yes | The locale where the session is in use. |
| sessionId | string | yes | The identifier of the session to delete. |

### Sends user input to Amazon Lex V2. Client applications use this API to send requests to Amazon Lex V2 at…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-runtime-lex-v2/recognize-text` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| botId | string | yes | The identifier of the bot that processes the request. |
| botAliasId | string | yes | The alias identifier in use for the bot that processes the request. |
| localeId | string | yes | The locale where the session is in use. |
| sessionId | string | yes | The identifier of the user session that is having the conversation. |
| body | object | yes | JSON request body |

### Sends user input to Amazon Lex V2. You can send text or speech. Clients use this API to send text and audio…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-runtime-lex-v2/recognize-utterance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| botId | string | yes | The identifier of the bot that should receive the request. |
| botAliasId | string | yes | The alias identifier in use for the bot that should receive the request. |
| localeId | string | yes | The locale where the session is in use. |
| sessionId | string | yes | The identifier of the session in use. |
| x-amz-lex-session-state | string | no | Sets the state of the session with the user. You can use this to set the current intent, attributes, context, and dialog action. Use the… |
| x-amz-lex-request-attributes | string | no | Request-specific information passed between the client application and Amazon Lex V2 The namespace x-amz-lex: is reserved for special… |
| Response-Content-Type | string | no | The message that Amazon Lex V2 returns in the response can be either text or speech based on the responseContentType value. If the value… |
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-runtime-lex-v2/get-session" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Amazon Lex Runtime V2 API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:amazonaws-runtime-lex-v2/get-session with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Amazon Lex Runtime V2 API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Amazon Lex Runtime V2 itself also needs your own key from amazonaws.com.

### Can AI agents use the Amazon Lex Runtime V2 API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-runtime-lex-v2.

### What is the status of the Amazon Lex Runtime V2 API?
Needs your own provider key (bring your own key)