Find an API

Search public APIs with auth details & Postman guides

← All APIs

Amazon Lex Runtime Service

amazonaws · Cloud

Cloud No Auth Free & Open cloud Sandbox

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 example, suppose a user says "I want pizza", your bot sends this input to Amazon Lex using the runtime API. Amazon Lex recognizes that the user request is for the OrderPizza intent (one of the intents defined in the bot). Then Amazon Lex engages in user conversation on behalf of the bot t

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET GetSession

Returns session information for a specified bot, alias, and user ID.

https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session?checkpointLabelFilter=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session/?checkpointLabelFilter=example"
import requests
params = {
    "checkpointLabelFilter": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session/",
    params=params,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session/');
url.searchParams.set('checkpointLabelFilter', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session/")
	q := baseURL.Query()
	q.Set("checkpointLabelFilter", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session/")
uri.query = URI.encode_www_form({
  "checkpointLabelFilter" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session/?" . http_build_query([
    "checkpointLabelFilter" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
POST PutSession

Creates a new session or modifies an existing session with an Amazon Lex bot. Use this operation to enable your application to set the state of the bot. For more information, see Managing Sessions .

https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session

Hover any highlighted part to learn what it does

curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session"
import requests
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session",
)
print(response.json())
const url = 'https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session';

const response = await fetch(url, {
  method: 'POST',
}); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session"
	req, _ := http.NewRequest("POST", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Post.new(uri)

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/session";
$opts = ["http" => [
    "method" => "POST",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
POST PostContent

Sends user input (text or speech) to Amazon Lex. Clients use this API to send text and audio requests to Amazon Lex at runtime. Amazon Lex interprets the user input using the machine learning model that it built for the bot. The PostContent operation supports audio input at

https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/content#Content-Type

Hover any highlighted part to learn what it does

Headers — extra info sent with the request
Content-Type example 
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/content#Content-Type" \
  -H "Content-Type: example"
import requests
headers = {
    "Content-Type": "example"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/content#Content-Type",
    headers=headers,
)
print(response.json())
const url = 'https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/content#Content-Type';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'example'
  },
}); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/content#Content-Type"
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("Content-Type", "example")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/content#Content-Type")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Post.new(uri)
req["Content-Type"] = "example"

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/runtime.lex/2016-11-28/bot/{botName}/alias/{botAlias}/user/{userId}/content#Content-Type";
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "Content-Type: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗
  1. See official documentation for authentication and setup.

What can you build with Amazon Lex Runtime Service?

Amazon Lex Runtime Service is a Cloud API. Developers commonly use cloud APIs for:

  • provisioning and managing cloud infrastructure
  • automating deployments and container orchestration
  • monitoring uptime and performance metrics
  • managing storage buckets and databases
  • setting up auto-scaling and load balancing

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Amazon Lex Runtime Service is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗