AWS Lambda Function URL API

Configure dedicated HTTPS endpoints for Lambda functions that can be invoked directly via HTTP

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /2021-10-31/functions/{FunctionName}/url Get a function URL and its settings · Aws Lambda Get Function Url Configuration #
Ask an LLM
“What is the HTTPS endpoint URL of my Lambda function?”
“Which auth type and CORS settings does my function URL use?”
Tell an agent
Show the function URL configuration of {function}.
Get the function URL for {function} alias {qualifier}.
POST /2021-10-31/functions/{FunctionName}/url Give a function a public HTTPS endpoint · Aws Lambda Create a Function Url #
Ask an LLM
“How do I expose a Lambda function over HTTPS without API Gateway?”
“Can I create a function URL that anyone can call without authentication?”
Tell an agent
Create a function URL for {function} with auth type {auth_type}.
Add a new function URL to {function} alias {qualifier} using auth {auth_type} and CORS {cors}.
PUT /2021-10-31/functions/{FunctionName}/url Change auth or CORS on a function URL · Aws Lambda Update a Function Url #
Ask an LLM
“How do I require IAM auth on a function URL that is currently public?”
“Can I change the allowed origins on an existing function URL?”
Tell an agent
Change the auth type of {function}'s function URL to {auth_type}.
Update the CORS settings on the existing function URL of {function} to {cors}.
DELETE /2021-10-31/functions/{FunctionName}/url Delete a function URL · Aws Lambda Delete a Function Url #
Ask an LLM
“How do I take down a function's public HTTPS endpoint?”
“Can I delete the function URL on one alias but keep the function?”
Tell an agent destructive · confirm first
Delete the function URL of {function}.
Remove the function URL from {function} alias {qualifier}.

Documentation

Specifications

Code Examples

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/aws-lambda-function-url-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

aws-lambda-function-url-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AWS Lambda Function URL API
  description: The AWS Lambda API enables you to create, configure, and manage Lambda functions, layers, event source mappings, aliases, versions, and function URLs programmatically. Lambda runs your code on high-availability compute infrastructure without provisioning or managing servers, performing all administration of compute resources including capacity provisioning, automatic scaling, and logging. The API version used is 2015-03-31.
  version: '2015-03-31'
  contact:
    name: AWS Support
    url: https://aws.amazon.com/contact-us/
  termsOfService: https://aws.amazon.com/service-terms/
servers:
- url: https://lambda.{region}.amazonaws.com
  description: AWS Lambda Regional Endpoint
  variables:
    region:
      description: The AWS region for the Lambda service endpoint
      default: us-east-1
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-north-1
      - ap-southeast-1
      - ap-southeast-2
      - ap-northeast-1
      - ap-northeast-2
      - ap-south-1
      - sa-east-1
      - ca-central-1
security:
- sigv4: []
tags:
- name: Function URL
  description: Configure dedicated HTTPS endpoints for Lambda functions that can be invoked directly via HTTP
paths:
  /2021-10-31/functions/{FunctionName}/url:
    get:
      operationId: getFunctionUrlConfig
      summary: Aws Lambda Get Function Url Configuration
      description: Returns details about a Lambda function URL, including the function URL itself, the authorization type, CORS settings, creation and modification timestamps, and the invoke mode.
      tags:
      - Function URL
      parameters:
      - $ref: '#/components/parameters/functionName'
      - $ref: '#/components/parameters/qualifier'
      responses:
        '200':
          description: Function URL configuration
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FunctionUrlConfig'
              examples:
                Getfunctionurlconfig200Example:
                  summary: Default getFunctionUrlConfig 200 response
                  x-microcks-default: true
                  value:
                    FunctionUrl: https://www.example.com
                    FunctionArn: example_value
                    AuthType: NONE
                    Cors:
                      AllowCredentials: true
                      AllowHeaders:
                      - {}
                      AllowMethods:
                      - {}
                      AllowOrigins:
                      - {}
                      ExposeHeaders:
                      - {}
                      MaxAge: 10
                    CreationTime: example_value
                    LastModifiedTime: example_value
                    InvokeMode: BUFFERED
        '404':
          description: Function URL configuration not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Getfunctionurlconfig404Example:
                  summary: Default getFunctionUrlConfig 404 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createFunctionUrlConfig
      summary: Aws Lambda Create a Function Url
      description: Creates a Lambda function URL with the specified authorization type. A function URL is a dedicated HTTP(S) endpoint that you can use to invoke your function. You can create a function URL for the $LATEST unpublished version or for any function alias.
      tags:
      - Function URL
      parameters:
      - $ref: '#/components/parameters/functionName'
      - $ref: '#/components/parameters/qualifier'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFunctionUrlConfigRequest'
            examples:
              CreatefunctionurlconfigRequestExample:
                summary: Default createFunctionUrlConfig request
                x-microcks-default: true
                value:
                  AuthType: NONE
                  Cors:
                    AllowCredentials: true
                    AllowHeaders:
                    - {}
                    AllowMethods:
                    - {}
                    AllowOrigins:
                    - {}
                    ExposeHeaders:
                    - {}
                    MaxAge: 10
                  InvokeMode: BUFFERED
      responses:
        '201':
          description: Function URL created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FunctionUrlConfig'
              examples:
                Createfunctionurlconfig201Example:
                  summary: Default createFunctionUrlConfig 201 response
                  x-microcks-default: true
                  value:
                    FunctionUrl: https://www.example.com
                    FunctionArn: example_value
                    AuthType: NONE
                    Cors:
                      AllowCredentials: true
                      AllowHeaders:
                      - {}
                      AllowMethods:
                      - {}
                      AllowOrigins:
                      - {}
                      ExposeHeaders:
                      - {}
                      MaxAge: 10
                    CreationTime: example_value
                    LastModifiedTime: example_value
                    InvokeMode: BUFFERED
        '404':
          description: Function not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Createfunctionurlconfig404Example:
                  summary: Default createFunctionUrlConfig 404 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
        '409':
          description: Function URL already exists
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Createfunctionurlconfig409Example:
                  summary: Default createFunctionUrlConfig 409 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: updateFunctionUrlConfig
      summary: Aws Lambda Update a Function Url
      description: Updates the configuration for a Lambda function URL.
      tags:
      - Function URL
      parameters:
      - $ref: '#/components/parameters/functionName'
      - $ref: '#/components/parameters/qualifier'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFunctionUrlConfigRequest'
            examples:
              UpdatefunctionurlconfigRequestExample:
                summary: Default updateFunctionUrlConfig request
                x-microcks-default: true
                value:
                  AuthType: NONE
                  Cors:
                    AllowCredentials: true
                    AllowHeaders:
                    - {}
                    AllowMethods:
                    - {}
                    AllowOrigins:
                    - {}
                    ExposeHeaders:
                    - {}
                    MaxAge: 10
                  InvokeMode: BUFFERED
      responses:
        '200':
          description: Function URL updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FunctionUrlConfig'
              examples:
                Updatefunctionurlconfig200Example:
                  summary: Default updateFunctionUrlConfig 200 response
                  x-microcks-default: true
                  value:
                    FunctionUrl: https://www.example.com
                    FunctionArn: example_value
                    AuthType: NONE
                    Cors:
                      AllowCredentials: true
                      AllowHeaders:
                      - {}
                      AllowMethods:
                      - {}
                      AllowOrigins:
                      - {}
                      ExposeHeaders:
                      - {}
                      MaxAge: 10
                    CreationTime: example_value
                    LastModifiedTime: example_value
                    InvokeMode: BUFFERED
        '404':
          description: Function URL not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Updatefunctionurlconfig404Example:
                  summary: Default updateFunctionUrlConfig 404 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteFunctionUrlConfig
      summary: Aws Lambda Delete a Function Url
      description: Deletes a Lambda function URL.
      tags:
      - Function URL
      parameters:
      - $ref: '#/components/parameters/functionName'
      - $ref: '#/components/parameters/qualifier'
      responses:
        '204':
          description: Function URL deleted
        '404':
          description: Function URL not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Deletefunctionurlconfig404Example:
                  summary: Default deleteFunctionUrlConfig 404 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    CreateFunctionUrlConfigRequest:
      type: object
      required:
      - AuthType
      description: Request body for creating a function URL
      properties:
        AuthType:
          type: string
          description: The type of authentication. NONE allows public unauthenticated access. AWS_IAM requires IAM authentication.
          enum:
          - NONE
          - AWS_IAM
          example: NONE
        Cors:
          $ref: '#/components/schemas/Cors'
        InvokeMode:
          type: string
          enum:
          - BUFFERED
          - RESPONSE_STREAM
          example: BUFFERED
    ErrorResponse:
      type: object
      description: Error response from the Lambda API
      properties:
        Type:
          type: string
          description: The error type
          example: example_value
        Message:
          type: string
          description: The error message
          example: example_value
        Code:
          type: string
          description: The error code
          example: example_value
    UpdateFunctionUrlConfigRequest:
      type: object
      description: Request body for updating a function URL configuration
      properties:
        AuthType:
          type: string
          enum:
          - NONE
          - AWS_IAM
          example: NONE
        Cors:
          $ref: '#/components/schemas/Cors'
        InvokeMode:
          type: string
          enum:
          - BUFFERED
          - RESPONSE_STREAM
          example: BUFFERED
    Cors:
      type: object
      description: Cross-origin resource sharing (CORS) settings for a function URL
      properties:
        AllowCredentials:
          type: boolean
          description: Whether to allow cookies or other credentials
          example: true
        AllowHeaders:
          type: array
          description: The HTTP headers allowed in requests
          items:
            type: string
          maxItems: 100
          example: []
        AllowMethods:
          type: array
          description: The HTTP methods allowed
          items:
            type: string
          maxItems: 6
          example: []
        AllowOrigins:
          type: array
          description: The origins allowed to access the function URL
          items:
            type: string
          maxItems: 100
          example: []
        ExposeHeaders:
          type: array
          description: The HTTP headers exposed in the response
          items:
            type: string
          maxItems: 100
          example: []
        MaxAge:
          type: integer
          description: Maximum time in seconds that a browser can cache results of a preflight request
          minimum: 0
          maximum: 86400
          example: 10
    FunctionUrlConfig:
      type: object
      description: Configuration for a Lambda function URL
      properties:
        FunctionUrl:
          type: string
          description: The HTTP URL endpoint for the function
          example: https://www.example.com
        FunctionArn:
          type: string
          description: The ARN of the function
          example: example_value
        AuthType:
          type: string
          description: The type of authentication the function URL uses
          enum:
          - NONE
          - AWS_IAM
          example: NONE
        Cors:
          $ref: '#/components/schemas/Cors'
        CreationTime:
          type: string
          description: When the function URL was created in ISO 8601 format
          example: example_value
        LastModifiedTime:
          type: string
          description: When the function URL was last modified
          example: example_value
        InvokeMode:
          type: string
          description: Use BUFFERED for synchronous invocation or RESPONSE_STREAM for response streaming
          enum:
          - BUFFERED
          - RESPONSE_STREAM
          example: BUFFERED
  parameters:
    functionName:
      name: FunctionName
      in: path
      required: true
      description: The name, ARN, or partial ARN of the Lambda function. Can be a function name, a function ARN, or a partial ARN.
      schema:
        type: string
        minLength: 1
        maxLength: 170
    qualifier:
      name: Qualifier
      in: query
      description: A version number or alias name
      schema:
        type: string
        minLength: 1
        maxLength: 128
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4 authentication. Requests must be signed with valid AWS credentials that have the appropriate Lambda IAM permissions.
externalDocs:
  description: AWS Lambda API Reference
  url: https://docs.aws.amazon.com/lambda/latest/api/welcome.html