AWS Lambda

AWS Lambda Layers API

Manage Lambda layers that package libraries, custom runtimes, and other dependencies for sharing across functions

GitHub OpenAPI

Operations 5

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 /2015-03-31/layers List Lambda layers and their latest version · Aws Lambda List Layers #
Ask an LLM
“What Lambda layers are available in my account?”
“Can I find only layers that work with Python 3.12 or arm64?”
Tell an agent
List my Lambda layers with their latest versions.
List layers compatible with runtime {runtime} and architecture {architecture}.
GET /2015-03-31/layers/{LayerName}/versions List the versions of one layer · Aws Lambda List Layer Versions #
Ask an LLM
“Which versions of a shared layer have been published?”
“Can I list only the versions of a layer that support a given runtime?”
Tell an agent
List every version of layer {layer}.
List versions of layer {layer} compatible with {runtime}.
POST /2015-03-31/layers/{LayerName}/versions Publish a new layer version from a ZIP · Aws Lambda Publish a Layer Version #
Ask an LLM
“How do I package shared libraries as a Lambda layer?”
“Can I declare which runtimes and license a layer version supports when I publish it?”
Tell an agent
Publish a new version of layer {layer} from archive {content}.
Publish layer {layer} from {content} for runtimes {runtimes} under license {license}.
GET /2015-03-31/layers/{LayerName}/versions/{VersionNumber} Get a layer version and its download link · Aws Lambda Get a Layer Version #
Ask an LLM
“How do I download the archive behind a specific layer version?”
“What runtimes and license does a given layer version declare?”
Tell an agent
Get version {version} of layer {layer} with its download link.
Show the compatible runtimes of {layer} version {version}.
DELETE /2015-03-31/layers/{LayerName}/versions/{VersionNumber} Delete a layer version · Aws Lambda Delete a Layer Version #
Ask an LLM
“How do I retire an old layer version so nobody can add it to new functions?”
“Do functions already using a layer version break when I delete it?”
Tell an agent destructive · confirm first
Delete version {version} of layer {layer}.
Retire layer {layer} version {version}.

Documentation

📖
Documentation
https://docs.aws.amazon.com/lambda/latest/dg/welcome.html
📖
APIReference
https://docs.aws.amazon.com/lambda/latest/api/welcome.html
📖
GettingStarted
https://aws.amazon.com/lambda/getting-started/
📖
RateLimits
https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html
📖
BestPractices
https://docs.aws.amazon.com/lambda/latest/dg/best-practices.html
📖
Troubleshooting
https://docs.aws.amazon.com/lambda/latest/dg/troubleshooting-deployment.html

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/aws-lambda/refs/heads/main/openapi/aws-lambda-layers-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/aws-lambda/refs/heads/main/asyncapi/aws-lambda-event-triggers-asyncapi.yml

Code Examples

💻
CodeExamples
https://docs.aws.amazon.com/lambda/latest/dg/service_code_examples.html

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/aws-lambda/refs/heads/main/json-schema/aws-lambda-function-schema.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/aws-lambda/refs/heads/main/json-ld/aws-lambda-context.jsonld
🔗
Pricing
https://aws.amazon.com/lambda/pricing/
🔗
SDKs
https://aws.amazon.com/tools/
🔗
Console
https://console.aws.amazon.com/lambda/
🔗
StatusPage
https://health.aws.amazon.com/health/status
🔗
Security
https://docs.aws.amazon.com/lambda/latest/dg/lambda-security.html
🔗
Tutorials
https://aws.amazon.com/lambda/resources/
🔗
CLI
https://docs.aws.amazon.com/cli/latest/reference/lambda/
🔗
Versioning
https://docs.aws.amazon.com/lambda/latest/dg/configuration-versions.html

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:aws-lambda-layers-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.

GitHub Google LinkedIn

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

OpenAPI Specification

aws-lambda-layers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: AWS Lambda Layers 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: Layers
  description: Manage Lambda layers that package libraries, custom runtimes, and other dependencies for sharing across functions
paths:
  /2015-03-31/layers:
    get:
      operationId: listLayers
      summary: Aws Lambda List Layers
      description: Lists Lambda layers and shows information about the latest version of each. Specify a compatible runtime to list only layers that are compatible with that runtime. Specify a compatible architecture to include only layers that are compatible with that instruction set architecture.
      tags:
      - Layers
      parameters:
      - name: CompatibleRuntime
        in: query
        description: Filter layers by compatible runtime
        schema:
          type: string
          enum:
          - nodejs18.x
          - nodejs20.x
          - nodejs22.x
          - python3.9
          - python3.10
          - python3.11
          - python3.12
          - python3.13
          - java11
          - java17
          - java21
          - dotnet6
          - dotnet8
          - ruby3.2
          - ruby3.3
          - provided
          - provided.al2
          - provided.al2023
        example: nodejs18.x
      - name: CompatibleArchitecture
        in: query
        description: Filter layers by compatible instruction set architecture
        schema:
          type: string
          enum:
          - x86_64
          - arm64
        example: x86_64
      - $ref: '#/components/parameters/marker'
      - $ref: '#/components/parameters/maxItems'
      responses:
        '200':
          description: List of layers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListLayersResponse'
              examples:
                Listlayers200Example:
                  summary: Default listLayers 200 response
                  x-microcks-default: true
                  value:
                    NextMarker: example_value
                    Layers:
                    - LayerName: example_value
                      LayerArn: example_value
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Listlayers429Example:
                  summary: Default listLayers 429 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2015-03-31/layers/{LayerName}/versions:
    get:
      operationId: listLayerVersions
      summary: Aws Lambda List Layer Versions
      description: Lists the versions of an Lambda layer. Versions that have been deleted are not listed. Specify a runtime identifier to list only versions compatible with that runtime.
      tags:
      - Layers
      parameters:
      - $ref: '#/components/parameters/layerName'
      - name: CompatibleRuntime
        in: query
        description: Filter by compatible runtime
        schema:
          type: string
        example: example_value
      - name: CompatibleArchitecture
        in: query
        description: Filter by compatible architecture
        schema:
          type: string
          enum:
          - x86_64
          - arm64
        example: x86_64
      - $ref: '#/components/parameters/marker'
      - $ref: '#/components/parameters/maxItems'
      responses:
        '200':
          description: List of layer versions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListLayerVersionsResponse'
              examples:
                Listlayerversions200Example:
                  summary: Default listLayerVersions 200 response
                  x-microcks-default: true
                  value:
                    NextMarker: example_value
                    LayerVersions:
                    - LayerVersionArn: example_value
                      Version: 10
                      Description: A sample description.
                      CreatedDate: example_value
                      CompatibleRuntimes: {}
                      LicenseInfo: example_value
                      CompatibleArchitectures: {}
        '404':
          description: Layer not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Listlayerversions404Example:
                  summary: Default listLayerVersions 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: publishLayerVersion
      summary: Aws Lambda Publish a Layer Version
      description: Creates a Lambda layer from a ZIP archive. Each time you call PublishLayerVersion with the same layer name, a new version is created. Add layers to your function with CreateFunction or UpdateFunctionConfiguration.
      tags:
      - Layers
      parameters:
      - $ref: '#/components/parameters/layerName'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublishLayerVersionRequest'
            examples:
              PublishlayerversionRequestExample:
                summary: Default publishLayerVersion request
                x-microcks-default: true
                value:
                  Description: A sample description.
                  Content:
                    S3Bucket: example_value
                    S3Key: example_value
                    S3ObjectVersion: example_value
                    ZipFile: example_value
                  CompatibleRuntimes:
                  - example_value
                  LicenseInfo: example_value
                  CompatibleArchitectures:
                  - x86_64
      responses:
        '201':
          description: Layer version published
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublishLayerVersionResponse'
              examples:
                Publishlayerversion201Example:
                  summary: Default publishLayerVersion 201 response
                  x-microcks-default: true
                  value:
                    Content:
                      Location: example_value
                      CodeSha256: example_value
                      CodeSize: 10
                      SigningProfileVersionArn: example_value
                      SigningJobArn: example_value
                    LayerArn: example_value
                    LayerVersionArn: example_value
                    Description: A sample description.
                    CreatedDate: example_value
                    Version: 10
                    CompatibleRuntimes:
                    - example_value
                    LicenseInfo: example_value
                    CompatibleArchitectures:
                    - example_value
        '400':
          description: Invalid parameter value
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Publishlayerversion400Example:
                  summary: Default publishLayerVersion 400 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Publishlayerversion429Example:
                  summary: Default publishLayerVersion 429 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2015-03-31/layers/{LayerName}/versions/{VersionNumber}:
    get:
      operationId: getLayerVersion
      summary: Aws Lambda Get a Layer Version
      description: Returns information about a version of a Lambda layer, with a link to download the layer archive that is valid for 10 minutes.
      tags:
      - Layers
      parameters:
      - $ref: '#/components/parameters/layerName'
      - $ref: '#/components/parameters/versionNumber'
      responses:
        '200':
          description: Layer version details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetLayerVersionResponse'
              examples:
                Getlayerversion200Example:
                  summary: Default getLayerVersion 200 response
                  x-microcks-default: true
                  value:
                    Content:
                      Location: example_value
                      CodeSha256: example_value
                      CodeSize: 10
                    LayerArn: example_value
                    LayerVersionArn: example_value
                    Description: A sample description.
                    CreatedDate: example_value
                    Version: 10
                    CompatibleRuntimes:
                    - example_value
                    LicenseInfo: example_value
                    CompatibleArchitectures:
                    - example_value
        '404':
          description: Layer version not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Getlayerversion404Example:
                  summary: Default getLayerVersion 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: deleteLayerVersion
      summary: Aws Lambda Delete a Layer Version
      description: Deletes a version of an Lambda layer. Deleted versions can no longer be viewed or added to functions. However, a copy of the version remains in Lambda until no functions refer to it.
      tags:
      - Layers
      parameters:
      - $ref: '#/components/parameters/layerName'
      - $ref: '#/components/parameters/versionNumber'
      responses:
        '204':
          description: Layer version deleted
        '404':
          description: Layer version not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Deletelayerversion404Example:
                  summary: Default deleteLayerVersion 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:
    GetLayerVersionResponse:
      type: object
      description: Details about a layer version
      properties:
        Content:
          type: object
          properties:
            Location:
              type: string
              description: A presigned URL to download the layer archive
            CodeSha256:
              type: string
            CodeSize:
              type: integer
              format: int64
          example: example_value
        LayerArn:
          type: string
          example: example_value
        LayerVersionArn:
          type: string
          example: example_value
        Description:
          type: string
          example: A sample description.
        CreatedDate:
          type: string
          example: example_value
        Version:
          type: integer
          example: 10
        CompatibleRuntimes:
          type: array
          items:
            type: string
          example: []
        LicenseInfo:
          type: string
          example: example_value
        CompatibleArchitectures:
          type: array
          items:
            type: string
          example: []
    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
    PublishLayerVersionRequest:
      type: object
      required:
      - Content
      description: Request body for publishing a layer version
      properties:
        Description:
          type: string
          description: Description of the layer version
          maxLength: 256
          example: A sample description.
        Content:
          type: object
          required: []
          description: The function layer archive
          properties:
            S3Bucket:
              type: string
              description: The S3 bucket of the layer archive
            S3Key:
              type: string
              description: The S3 key of the layer archive
            S3ObjectVersion:
              type: string
              description: For versioned objects, the version of the layer archive
            ZipFile:
              type: string
              format: byte
              description: Base64-encoded contents of the layer archive .zip file
          example: example_value
        CompatibleRuntimes:
          type: array
          description: A list of compatible runtimes. Used for filtering with ListLayers and ListLayerVersions.
          items:
            type: string
          maxItems: 15
          example: []
        LicenseInfo:
          type: string
          description: The layer's software license (SPDX identifier, URL, or text)
          maxLength: 512
          example: example_value
        CompatibleArchitectures:
          type: array
          description: A list of compatible instruction set architectures
          items:
            type: string
            enum:
            - x86_64
            - arm64
          maxItems: 2
          example: []
    PublishLayerVersionResponse:
      type: object
      description: Details about a published layer version
      properties:
        Content:
          type: object
          properties:
            Location:
              type: string
              description: A link to download the layer archive (valid for 10 minutes)
            CodeSha256:
              type: string
              description: The SHA-256 hash of the layer archive
            CodeSize:
              type: integer
              description: The size of the layer archive in bytes
              format: int64
            SigningProfileVersionArn:
              type: string
            SigningJobArn:
              type: string
          example: example_value
        LayerArn:
          type: string
          description: The ARN of the layer
          example: example_value
        LayerVersionArn:
          type: string
          description: The ARN of the layer version
          example: example_value
        Description:
          type: string
          description: Description of the version
          example: A sample description.
        CreatedDate:
          type: string
          description: The date the layer version was created in ISO 8601 format
          example: example_value
        Version:
          type: integer
          description: The version number
          example: 10
        CompatibleRuntimes:
          type: array
          items:
            type: string
          example: []
        LicenseInfo:
          type: string
          example: example_value
        CompatibleArchitectures:
          type: array
          items:
            type: string
          example: []
    ListLayersResponse:
      type: object
      description: Paginated list of layers
      properties:
        NextMarker:
          type: string
          example: example_value
        Layers:
          type: array
          items:
            type: object
            properties:
              LayerName:
                type: string
                description: The name of the layer
              LayerArn:
                type: string
                description: The ARN of the layer
              LatestMatchingVersion:
                $ref: '#/components/schemas/LayerVersionSummary'
          example: []
    LayerVersionSummary:
      type: object
      description: Summary information about a layer version
      properties:
        LayerVersionArn:
          type: string
          description: The ARN of the layer version
          example: example_value
        Version:
          type: integer
          description: The version number
          example: 10
        Description:
          type: string
          description: Description of the version
          example: A sample description.
        CreatedDate:
          type: string
          description: The date the version was created
          example: example_value
        CompatibleRuntimes:
          type: array
          items:
            type: string
          example: []
        LicenseInfo:
          type: string
          example: example_value
        CompatibleArchitectures:
          type: array
          items:
            type: string
          example: []
    ListLayerVersionsResponse:
      type: object
      description: Paginated list of layer versions
      properties:
        NextMarker:
          type: string
          example: example_value
        LayerVersions:
          type: array
          items:
            $ref: '#/components/schemas/LayerVersionSummary'
          example: []
  parameters:
    layerName:
      name: LayerName
      in: path
      required: true
      description: The name or ARN of the layer
      schema:
        type: string
        minLength: 1
        maxLength: 140
    versionNumber:
      name: VersionNumber
      in: path
      required: true
      description: The version number
      schema:
        type: integer
    maxItems:
      name: MaxItems
      in: query
      description: Maximum number of items to return (1-10000)
      schema:
        type: integer
        minimum: 1
        maximum: 10000
    marker:
      name: Marker
      in: query
      description: A pagination token returned by a previous call. Use this token to retrieve the next page of results.
      schema:
        type: string
  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