# Amazon Lex Runtime Service API

> Amazon Lex Runtime Service API on Apizie: 5 endpoints (Creates a new session or modifies an existing session with an Amazon Lex bot. Use this operation to enable…, Removes session information for a specified bot, alias, and user ID., Returns session information for a specified bot, alias, and user ID., Sends user input (text or speech) to Amazon Lex. Clients use this API to send text and audio requests to…, …) 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://apizie.tech/v1/cloud:amazonaws-runtime-lex/{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`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://apizie.tech/api/cloud/amazonaws-runtime-lex
- OpenAPI: https://apizie.tech/api/cloud/amazonaws-runtime-lex/openapi.json

Amazon Lex provides both build and runtime endpoints. Each endpoint provides a set of operations (API). Your conversational bot uses the runtime API to understand user utterances (user input text or voice). For…

## Endpoints

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| botName | string | yes | The name of the bot that contains the session data. |
| botAlias | string | yes | The alias in use for the bot that contains the session data. |
| userId | string | yes | The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. |
| body | object | yes | JSON request body |

### Removes session information for a specified bot, alias, and user ID.
`POST https://apizie.tech/v1/cloud:amazonaws-runtime-lex/delete-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| botName | string | yes | The name of the bot that contains the session data. |
| botAlias | string | yes | The alias in use for the bot that contains the session data. |
| userId | string | yes | The identifier of the user associated with the session data. |

### Returns session information for a specified bot, alias, and user ID.
`GET https://apizie.tech/v1/cloud:amazonaws-runtime-lex/get-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| botName | string | yes | The name of the bot that contains the session data. |
| botAlias | string | yes | The alias in use for the bot that contains the session data. |
| userId | string | yes | The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. |
| checkpointLabelFilter | string | no | A string used to filter the intents returned in the recentIntentSummaryView structure. When you specify a filter, only intents with their… |

### Sends user input (text or speech) to Amazon Lex. Clients use this API to send text and audio requests to…
`POST https://apizie.tech/v1/cloud:amazonaws-runtime-lex/post-content` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| botName | string | yes | Name of the Amazon Lex bot. |
| botAlias | string | yes | Alias of the Amazon Lex bot. |
| userId | string | yes | The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must… |
| x-amz-lex-session-attributes | string | no | You pass this value as the x-amz-lex-session-attributes HTTP header. Application-specific information passed between Amazon Lex and a… |
| x-amz-lex-request-attributes | string | no | You pass this value as the x-amz-lex-request-attributes HTTP header. Request-specific information passed between Amazon Lex and a client… |
| x-amz-lex-active-contexts | string | no | A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in… |
| body | object | yes | JSON request body |

### Sends user input to Amazon Lex. Client applications can use this API to send requests to Amazon Lex at…
`POST https://apizie.tech/v1/cloud:amazonaws-runtime-lex/post-text` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| botName | string | yes | The name of the Amazon Lex bot. |
| botAlias | string | yes | The alias of the Amazon Lex bot. |
| userId | string | yes | The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must… |
| body | object | yes | JSON request body |

## Example
```
curl "https://apizie.tech/v1/cloud:amazonaws-runtime-lex/put-session" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Amazon Lex Runtime Service API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:amazonaws-runtime-lex/put-session with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Amazon Lex Runtime Service 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 Service itself also needs your own key from amazonaws.com.

### Can AI agents use the Amazon Lex Runtime Service API?
Yes. Add the Apizie MCP server (https://apizie.tech/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.

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