This endpoint discovers and lists all AWS Lambda functions available in your AWS account for the specified region and credentials. This is used by the Tools Library to provide an interactive function selector when creating Lambda tools.

​
Request Body

Send AWS credentials and region as query parameters:
Example Request
{
  "access_key": "AKIA1234567890EXAMPLE",
  "secret_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  "region": "us-east-1"
}

​
Query Parameters

  • access_key (string, required): AWS Access Key ID with Lambda permissions
  • secret_key (string, required): AWS Secret Access Key
  • region (string, optional, default: “us-east-1”): AWS region to search for Lambda functions

​
Response

A successful request returns detailed information about all Lambda functions:
Response
{
  "success": true,
  "message": "Found 3 Lambda functions",
  "functions": [
    {
      "function_name": "customer-lookup-service",
      "description": "Look up customer data by phone number",
      "runtime": "python3.9",
      "timeout": 30,
      "memory_size": 512,
      "code_size": 1024000,
      "handler": "lambda_function.lambda_handler",
      "version": "$LATEST",
      "last_modified": "2024-01-15T10:30:00.000Z"
    },
    {
      "function_name": "order-processing",
      "description": "Process customer orders and payments", 
      "runtime": "nodejs18.x",
      "timeout": 60,
      "memory_size": 1024,
      "code_size": 2048000,
      "handler": "index.handler",
      "version": "$LATEST",
      "last_modified": "2024-01-10T14:22:15.000Z"
    },
    {
      "function_name": "send-notifications",
      "description": "",
      "runtime": "python3.8", 
      "timeout": 15,
      "memory_size": 256,
      "code_size": 512000,
      "handler": "notification.send",
      "version": "$LATEST",
      "last_modified": "2024-01-05T09:15:30.000Z"
    }
  ]
}

​
Function Object Properties

Each function object in the response contains:
PropertyTypeDescription
function_namestringLambda function name (used for invocation)
descriptionstringFunction description (may be empty)
runtimestringRuntime environment (e.g., python3.9, nodejs18.x)
timeoutintegerFunction timeout in seconds
memory_sizeintegerAllocated memory in MB
code_sizeintegerFunction code size in bytes
handlerstringFunction entry point
versionstringFunction version (usually $LATEST)
last_modifiedstringISO timestamp of last modification

​
Error Responses

​
400 Bad Request - Missing Credentials

{
  "success": false,
  "detail": "AWS credentials not found. Please configure access_key and secret_key."
}

​
400 Bad Request - Invalid Credentials

{
  "success": false,
  "detail": "AWS error (InvalidUserID.NotFound): The AWS Access Key Id you provided does not exist in our records."
}

​
400 Bad Request - Access Denied

{
  "success": false,
  "detail": "AWS error (AccessDenied): User: arn:aws:iam::123456789012:user/example is not authorized to perform: lambda:ListFunctions"
}

​
500 Internal Server Error

{
  "success": false,
  "detail": "Failed to list Lambda functions: Connection timeout"
}

​
Required IAM Permissions

Your AWS credentials must have the following permissions:
IAM Policy
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:ListFunctions",
        "lambda:GetFunctionConfiguration"
      ],
      "Resource": "*"
    }
  ]
}

​
Usage in Tools Library

This endpoint is automatically called when users:
  1. Enter AWS credentials in the Lambda tool configuration form
  2. Select a region from the dropdown
  3. Click ”🔍 Discover Functions” button
  4. Browse the interactive function list to select their Lambda function
The selected function’s metadata is used to auto-populate the tool configuration form.

​
Rate Limits

  • Rate Limit: 10 requests per minute per organization
  • Timeout: 30 seconds maximum per request
  • Pagination: Returns all functions (AWS API handles pagination internally)

​
Example Usage

cURL Example
curl -X POST "https://api.burkivoice.ai/api/lambda/list-functions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "access_key=AKIA1234567890EXAMPLE" \
  -d "secret_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \
  -d "region=us-west-2"
Python Example
import requests

response = requests.post(
    "https://api.burkivoice.ai/api/lambda/list-functions",
    headers={"Authorization": "Bearer YOUR_API_TOKEN"},
    data={
        "access_key": "AKIA1234567890EXAMPLE",
        "secret_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", 
        "region": "us-east-1"
    }
)

functions = response.json()["functions"]
print(f"Found {len(functions)} Lambda functions")
JavaScript Example
const response = await fetch('/api/lambda/list-functions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  body: new URLSearchParams({
    access_key: 'AKIA1234567890EXAMPLE',
    secret_key: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
    region: 'us-east-1'
  })
});

const data = await response.json();
console.log(`Discovered ${data.functions.length} functions`);