AWS Lambda Concurrency API

Manage reserved and provisioned concurrency settings for functions

Operations 9

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/functions/{FunctionName}/concurrency Check a function's reserved concurrency · Aws Lambda Get Reserved Concurrency #
Ask an LLM
“How much reserved concurrency does my function currently have?”
“Is there a concurrency cap set on this Lambda function?”
Tell an agent
Show the reserved concurrency set on function {function}.
Tell me whether {function} has a reserved concurrent execution limit.
PUT /2015-03-31/functions/{FunctionName}/concurrency Reserve concurrency for a function · Aws Lambda Set Reserved Concurrency #
Ask an LLM
“How do I cap the number of simultaneous executions of a Lambda function?”
“Can I reserve part of my account's concurrency so one function is never starved?”
Tell an agent
Reserve {count} concurrent executions for function {function}.
Limit {function} to at most {count} simultaneous runs.
DELETE /2015-03-31/functions/{FunctionName}/concurrency Remove a function's reserved concurrency limit · Aws Lambda Delete Reserved Concurrency #
Ask an LLM
“How do I take the reserved concurrency limit off a function?”
“What happens to a function's concurrency after its reservation is removed?”
Tell an agent destructive · confirm first
Remove the reserved concurrency limit from function {function}.
Let {function} draw on unreserved account concurrency again by clearing its reservation.
GET /2015-03-31/functions/{FunctionName}/provisioned-concurrency Check provisioned concurrency on an alias or version · Aws Lambda Get Provisioned Concurrency #
Ask an LLM
“How many pre-warmed execution environments does my function's alias have?”
“Is provisioned concurrency ready yet on a given version of my function?”
Tell an agent
Show the provisioned concurrency config of function {function} for alias or version {qualifier}.
Check the warm-instance status on {function}:{qualifier}.
PUT /2015-03-31/functions/{FunctionName}/provisioned-concurrency Pre-warm execution environments for an alias · Aws Lambda Set Provisioned Concurrency #
Ask an LLM
“How do I eliminate cold starts on my production alias?”
“Can I keep a fixed number of Lambda environments initialized for a specific version?”
Tell an agent
Provision {count} pre-initialized environments for function {function} on alias {qualifier}.
Keep {count} warm instances of {function} version {qualifier} ready to respond.
DELETE /2015-03-31/functions/{FunctionName}/provisioned-concurrency Remove provisioned concurrency from an alias · Aws Lambda Delete Provisioned Concurrency #
Ask an LLM
“How do I stop paying for pre-warmed environments on an alias I no longer need?”
“Can I drop the provisioned concurrency from one version without touching others?”
Tell an agent destructive · confirm first
Delete the provisioned concurrency config of function {function} for {qualifier}.
Stop keeping warm instances for {function} alias {qualifier}.
DELETE /2017-10-31/functions/{FunctionName}/concurrency Delete Function Concurrency #
PUT /2017-10-31/functions/{FunctionName}/concurrency Put Function Concurrency #
GET /2019-09-30/functions/{FunctionName}/concurrency Get Function Concurrency #

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:aws-lambda-concurrency-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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-concurrency-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Aws Lambda Concurrency API
  version: '2015-03-31'
  description: 'Operations tagged Concurrency across 2 of this provider''s published API definitions: aws-lambda-api-openapi.yml, aws-lambda-concurrency-api-openapi.yml. Each path carries the servers of the definition it was published in.'
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: Concurrency
  description: Manage reserved and provisioned concurrency settings for functions
paths:
  /2015-03-31/functions/{FunctionName}/concurrency:
    get:
      operationId: getReservedConcurrency
      summary: Aws Lambda Get Reserved Concurrency
      description: Retrieves the reserved concurrency configuration for a function.
      tags:
      - Concurrency
      parameters:
      - $ref: '#/components/parameters/functionName'
      responses:
        '200':
          description: Reserved concurrency configuration
          content:
            application/json:
              schema:
                type: object
                properties:
                  ReservedConcurrentExecutions:
                    type: integer
                    description: The number of concurrent executions reserved for this function
              examples:
                Getreservedconcurrency200Example:
                  summary: Default getReservedConcurrency 200 response
                  x-microcks-default: true
                  value:
                    ReservedConcurrentExecutions: 10
        '404':
          description: Function not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Getreservedconcurrency404Example:
                  summary: Default getReservedConcurrency 404 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: putFunctionConcurrency
      summary: Aws Lambda Set Reserved Concurrency
      description: Sets the maximum number of simultaneous executions for a function, and reserves capacity for that concurrency level. Use ReservedConcurrentExecutions to reserve a portion of your account's concurrency for a function.
      tags:
      - Concurrency
      parameters:
      - $ref: '#/components/parameters/functionName'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - ReservedConcurrentExecutions
              properties:
                ReservedConcurrentExecutions:
                  type: integer
                  description: The number of simultaneous executions to reserve
                  minimum: 0
            examples:
              PutfunctionconcurrencyRequestExample:
                summary: Default putFunctionConcurrency request
                x-microcks-default: true
                value:
                  ReservedConcurrentExecutions: 10
      responses:
        '200':
          description: Reserved concurrency set
          content:
            application/json:
              schema:
                type: object
                properties:
                  ReservedConcurrentExecutions:
                    type: integer
              examples:
                Putfunctionconcurrency200Example:
                  summary: Default putFunctionConcurrency 200 response
                  x-microcks-default: true
                  value:
                    ReservedConcurrentExecutions: 10
        '404':
          description: Function not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Putfunctionconcurrency404Example:
                  summary: Default putFunctionConcurrency 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: deleteFunctionConcurrency
      summary: Aws Lambda Delete Reserved Concurrency
      description: Removes a concurrency limit from a function. The function can then use unreserved account concurrency up to the account limit.
      tags:
      - Concurrency
      parameters:
      - $ref: '#/components/parameters/functionName'
      responses:
        '204':
          description: Reserved concurrency removed
        '404':
          description: Function not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Deletefunctionconcurrency404Example:
                  summary: Default deleteFunctionConcurrency 404 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    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
  /2015-03-31/functions/{FunctionName}/provisioned-concurrency:
    get:
      operationId: getProvisionedConcurrencyConfig
      summary: Aws Lambda Get Provisioned Concurrency
      description: Retrieves the provisioned concurrency configuration for a function's alias or version.
      tags:
      - Concurrency
      parameters:
      - $ref: '#/components/parameters/functionName'
      - name: Qualifier
        in: query
        required: true
        description: The version number or alias name
        schema:
          type: string
        example: example_value
      responses:
        '200':
          description: Provisioned concurrency configuration
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProvisionedConcurrencyConfig'
              examples:
                Getprovisionedconcurrencyconfig200Example:
                  summary: Default getProvisionedConcurrencyConfig 200 response
                  x-microcks-default: true
                  value:
                    RequestedProvisionedConcurrentExecutions: 10
                    AvailableProvisionedConcurrentExecutions: 10
                    AllocatedProvisionedConcurrentExecutions: 10
                    Status: IN_PROGRESS
                    StatusReason: example_value
                    LastModified: example_value
        '404':
          description: Configuration not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Getprovisionedconcurrencyconfig404Example:
                  summary: Default getProvisionedConcurrencyConfig 404 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: putProvisionedConcurrencyConfig
      summary: Aws Lambda Set Provisioned Concurrency
      description: Adds a provisioned concurrency configuration to a function's alias or version. Lambda pre-initializes the specified number of execution environments so they are prepared to respond immediately.
      tags:
      - Concurrency
      parameters:
      - $ref: '#/components/parameters/functionName'
      - name: Qualifier
        in: query
        required: true
        description: The version number or alias name
        schema:
          type: string
        example: example_value
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - ProvisionedConcurrentExecutions
              properties:
                ProvisionedConcurrentExecutions:
                  type: integer
                  description: The amount of provisioned concurrency to allocate
                  minimum: 1
            examples:
              PutprovisionedconcurrencyconfigRequestExample:
                summary: Default putProvisionedConcurrencyConfig request
                x-microcks-default: true
                value:
                  ProvisionedConcurrentExecutions: 10
      responses:
        '202':
          description: Provisioned concurrency configuration created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProvisionedConcurrencyConfig'
              examples:
                Putprovisionedconcurrencyconfig202Example:
                  summary: Default putProvisionedConcurrencyConfig 202 response
                  x-microcks-default: true
                  value:
                    RequestedProvisionedConcurrentExecutions: 10
                    AvailableProvisionedConcurrentExecutions: 10
                    AllocatedProvisionedConcurrentExecutions: 10
                    Status: IN_PROGRESS
                    StatusReason: example_value
                    LastModified: example_value
        '404':
          description: Function or qualifier not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Putprovisionedconcurrencyconfig404Example:
                  summary: Default putProvisionedConcurrencyConfig 404 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
        '409':
          description: Resource conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Putprovisionedconcurrencyconfig409Example:
                  summary: Default putProvisionedConcurrencyConfig 409 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteProvisionedConcurrencyConfig
      summary: Aws Lambda Delete Provisioned Concurrency
      description: Deletes the provisioned concurrency configuration for a function.
      tags:
      - Concurrency
      parameters:
      - $ref: '#/components/parameters/functionName'
      - name: Qualifier
        in: query
        required: true
        description: The version number or alias name
        schema:
          type: string
        example: example_value
      responses:
        '204':
          description: Provisioned concurrency configuration deleted
        '404':
          description: Configuration not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Deleteprovisionedconcurrencyconfig404Example:
                  summary: Default deleteProvisionedConcurrencyConfig 404 response
                  x-microcks-default: true
                  value:
                    Type: example_value
                    Message: example_value
                    Code: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    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
  /2017-10-31/functions/{FunctionName}/concurrency:
    delete:
      operationId: DeleteFunctionConcurrency
      summary: Delete Function Concurrency
      description: Removes a concurrent execution limit from a function.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
        '400':
          description: InvalidParameterValueException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '409':
          description: ResourceConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceConflictException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '500':
          description: ServiceException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceException'
        '429':
          description: TooManyRequestsException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteFunctionConcurrencyRequest'
            example:
              FunctionName: my-function
      tags:
      - Concurrency
    put:
      operationId: PutFunctionConcurrency
      summary: Put Function Concurrency
      description: Sets the maximum number of simultaneous executions for a function, and reserves capacity for that concurrency level. Concurrency settings apply to the function as a whole, including all published versions and the unpublished version. Reserving concurrency both ensures that your function has capacity to process the specified number of events simultaneously, and prevents it from scaling beyond that level. Use GetFunction to see the current setting for a function. Use GetAccountSettings to see your Regional concurrency limit. You can reserve concurrency for as many functions as you like, as long as you leave at least 100 simultaneous executions unreserved for functions that aren't configured with a per-function limit. For more information, see Lambda function scaling.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Concurrency'
              example:
                ReservedConcurrentExecutions: 100
        '400':
          description: InvalidParameterValueException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '409':
          description: ResourceConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceConflictException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '500':
          description: ServiceException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceException'
        '429':
          description: TooManyRequestsException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutFunctionConcurrencyRequest'
            example:
              FunctionName: my-function
              ReservedConcurrentExecutions: 100
      tags:
      - Concurrency
    servers:
    - url: https://lambda.{region}.amazonaws.com
      variables:
        region:
          default: us-east-1
  /2019-09-30/functions/{FunctionName}/concurrency:
    get:
      operationId: GetFunctionConcurrency
      summary: Get Function Concurrency
      description: Returns details about the reserved concurrency configuration for a function. To set a concurrency limit for a function, use PutFunctionConcurrency.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetFunctionConcurrencyResponse'
              example:
                ReservedConcurrentExecutions: 250
        '400':
          description: InvalidParameterValueException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '500':
          description: ServiceException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceException'
        '429':
          description: TooManyRequestsException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetFunctionConcurrencyRequest'
            example:
              FunctionName: my-function
      tags:
      - Concurrency
    servers:
    - url: https://lambda.{region}.amazonaws.com
      variables:
        region:
          default: us-east-1
components:
  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
  schemas:
    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
    ProvisionedConcurrencyConfig:
      type: object
      description: Provisioned concurrency configuration for a function
      properties:
        RequestedProvisionedConcurrentExecutions:
          type: integer
          description: The amount of provisioned concurrency requested
          example: 10
        AvailableProvisionedConcurrentExecutions:
          type: integer
          description: The amount of provisioned concurrency available
          example: 10
        AllocatedProvisionedConcurrentExecutions:
          type: integer
          description: The amount of provisioned concurrency allocated
          example: 10
        Status:
          type: string
          description: The status of the allocation
          enum:
          - IN_PROGRESS
          - READY
          - FAILED
          example: IN_PROGRESS
        StatusReason:
          type: string
          description: For failed allocations, the reason the status is FAILED
          example: example_value
        LastModified:
          type: string
          description: The date and time the configuration was last modified
          example: example_value
    Concurrency:
      type: object
      properties:
        ReservedConcurrentExecutions:
          type: integer
          description: The number of concurrent executions that are reserved for this function. For more information, see Managing Lambda reserved concurrency.
    ResourceConflictException:
      type: object
      properties:
        Type:
          type: string
          description: The exception type.
        message:
          type: string
          description: The exception message.
    ResourceNotFoundException:
      type: object
      properties:
        Type:
          type: string
        Message:
          type: string
    TooManyRequestsException:
      type: object
      properties:
        retryAfterSeconds:
          type: string
          description: The number of seconds the caller should wait before retrying.
        Type:
          type: string
        message:
          type: string
        Reason:
          type: string
          enum:
          - ConcurrentInvocationLimitExceeded
          - FunctionInvocationRateLimitExceeded
          - ReservedFunctionConcurrentInvocationLimitExceeded
          - ReservedFunctionInvocationRateLimitExceeded
          - CallerRateLimitExceeded
          - ConcurrentSnapshotCreateLimitExceeded
    GetFunctionConcurrencyResponse:
      type: object
      properties:
        ReservedConcurrentExecutions:
          type: integer
          description: The number of simultaneous executions that are reserved for the function.
    DeleteFunctionConcurrencyRequest:
      type: object
      properties:
        FunctionName:
          type: string
          description: The name or ARN of the Lambda function. Name formats Function name – my-function. Function ARN – arn:aws:lambda:us-west-2:123456789012:function:my-function. Partial ARN – 123456789012:function:my-function. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.
      required:
      - FunctionName
    ServiceException:
      type: object
      properties:
        Type:
          type: string
        Message:
          type: string
    InvalidParameterValueException:
      type: object
      properties:
        Type:
          type: string
          description: The exception type.
        message:
          type: string
          description: The exception message.
    PutFunctionConcurrencyRequest:
      type: object
      properties:
        FunctionName:
          type: string
          description: The name or ARN of the Lambda function. Name formats Function name – my-function. Function ARN – arn:aws:lambda:us-west-2:123456789012:function:my-function. Partial ARN – 123456789012:function:my-function. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.
        ReservedConcurrentExecutions:
          type: integer
          description: The number of simultaneous executions to reserve for the function.
      required:
      - FunctionName
      - ReservedConcurrentExecutions
    GetFunctionConcurrencyRequest:
      type: object
      properties:
        FunctionName:
          type: string
          description: The name or ARN of the Lambda function. Name formats Function name – my-function. Function ARN – arn:aws:lambda:us-west-2:123456789012:function:my-function. Partial ARN – 123456789012:function:my-function. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.
      required:
      - FunctionName
  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
x-refined-from:
- aws-lambda-api-openapi.yml
- aws-lambda-concurrency-api-openapi.yml