> ## Documentation Index
> Fetch the complete documentation index at: https://doc.gapstack.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List Lambda resources for a project



## OpenAPI

````yaml /api-reference/openapi.yaml get /project/{projectId}/lambdas
openapi: 3.0.3
info:
  title: Gapstack API
  version: '1.0'
  description: >-
    REST API for Gapstack tenants, projects, environments, resources, and
    integrations.
servers:
  - url: https://9nr7sbhimh.execute-api.us-west-1.amazonaws.com/prod
    description: Production
security:
  - BearerAuth: []
tags:
  - name: healthcheck
    description: Service health
  - name: tenants
    description: Tenants, members, infrastructure, and API keys
  - name: invitations
    description: Tenant invitations
  - name: projects
    description: Projects, variables, webhooks, and integrations
  - name: environments
    description: Environments, deploys, artifacts, and variables
  - name: resources
    description: Cloud resources
  - name: workflows
    description: Deployment and infrastructure workflows
  - name: aws-accounts
    description: Linked AWS accounts
  - name: integrations
    description: Marketplace integrations
  - name: github
    description: GitHub App install and webhooks
  - name: costs
    description: Aggregated cloud costs
  - name: summary
    description: Tenant dashboard summary
  - name: subscription
    description: Plans, usage, and billing webhooks
  - name: settings
    description: System settings, permissions, and superadmins
paths:
  /project/{projectId}/lambdas:
    get:
      tags:
        - projects
      summary: List Lambda resources for a project
      operationId: listProjectLambdas
      parameters:
        - $ref: '#/components/parameters/TenantId'
        - $ref: '#/components/parameters/ProjectId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/LambdaResourceDetails'
        '400':
          description: Bad request, validation failure, or applicable mapped 4xx errors.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid bearer token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Authenticated but not allowed (e.g. subscription limits).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict (e.g. duplicate or already exists).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
        - ApiKeyAuth: []
components:
  parameters:
    TenantId:
      name: Tenant-Id
      in: header
      required: true
      schema:
        type: string
      description: ID of the tenant (current tenant context).
    ProjectId:
      name: projectId
      in: path
      required: true
      schema:
        type: string
      description: Project identifier.
  schemas:
    LambdaResourceDetails:
      allOf:
        - $ref: '#/components/schemas/BaseResourceDetails'
        - type: object
          description: Lambda-specific fields (stack_info from deployment).
          properties:
            function_name:
              type: string
            runtime:
              $ref: '#/components/schemas/LambdaRuntime'
            architecture:
              $ref: '#/components/schemas/LambdaArchitecture'
            memory_size:
              type: integer
            handler:
              type: string
            timeout:
              type: integer
            code:
              type: string
            retry_attempts:
              type: integer
            artifact_version:
              type: string
            inline_policy:
              type: string
            allow_actions:
              type: array
              items:
                type: string
            allow_resources:
              type: array
              items:
                type: string
            layers:
              type: array
              items:
                $ref: '#/components/schemas/LambdaLayer'
            artifact_type:
              nullable: true
              description: >-
                Type of deployable artifact (null or omitted = regular S3
                artifact).
              allOf:
                - $ref: '#/components/schemas/LambdaArtifactType'
            ecr_config:
              nullable: true
              allOf:
                - $ref: '#/components/schemas/LambdaECRConfig'
            stack_info:
              $ref: '#/components/schemas/LambdaResourceStackInfo'
            month_cost:
              nullable: true
    ErrorResponse:
      type: object
      description: >
        JSON body returned by WriteJsonError (internal/app/util.go
        errorResponse).

        Field `error` carries the human-readable message; `code` is set for
        Gapstack errors.
      properties:
        code:
          description: >
            Machine-readable code from paas-lib when the error is a
            GapstackError; omitted when not.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/PaasLibErrorCode'
        error:
          type: string
          description: Human-readable error message (JSON key `error`, not `message`).
        meta:
          type: object
          additionalProperties:
            type: string
          description: Optional metadata (e.g. validation field names).
    BaseResourceDetails:
      type: object
      description: Shared resource metadata (merged into each resource details schema).
      required:
        - name
        - description
        - resource_type
        - id
        - sk
        - type
        - created_at
        - updated_at
        - status
      properties:
        name:
          type: string
        description:
          type: string
        resource_type:
          $ref: '#/components/schemas/ResourceType'
        id:
          type: string
          x-go-name: Pk
        sk:
          type: string
        type:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        status:
          $ref: '#/components/schemas/ResourceStatus'
        deletable:
          type: boolean
    LambdaRuntime:
      type: string
      description: models.LambdaRuntime (paas-lib).
      enum:
        - nodejs4.3
        - nodejs6.10
        - nodejs8.10
        - nodejs10.x
        - nodejs12.x
        - nodejs14.x
        - nodejs16.x
        - nodejs18.x
        - nodejs20.x
        - nodejs_latest
        - nodejs22.x
        - python2.7
        - python3.6
        - python3.7
        - python3.8
        - python3.9
        - python3.10
        - python3.11
        - python3.12
        - python3.13
        - java8
        - java8.corretto
        - java11
        - java17
        - java21
        - dotnet6
        - dotnet8
        - dotnet9
        - dotnetcore1
        - dotnetcore2
        - dotnetcore2.1
        - dotnetcore3.1
        - go1.x
        - ruby2.5
        - ruby2.7
        - ruby3.2
        - ruby3.3
        - ruby3.4
        - provided
        - provided.al2
        - provided.al2023
        - from_image
    LambdaArchitecture:
      type: string
      description: models.LambdaArchitecture (paas-lib).
      enum:
        - arm64
        - x86_64
      x-enum-varnames:
        - LambdaArchitectureArm64
        - LambdaArchitectureX8664
    LambdaLayer:
      type: object
      required:
        - code_path
      properties:
        code_path:
          type: string
          description: Path to the layer code in the environment artifacts S3 bucket.
    LambdaArtifactType:
      type: string
      description: >-
        models.LambdaArtifactType (paas-lib). Omitted or null means regular S3
        artifact (code path).
      enum:
        - artifact
        - ecr_image
      x-enum-varnames:
        - LambdaArtifactTypeArtifact
        - LambdaArtifactTypeECRImage
    LambdaECRConfig:
      type: object
      description: >-
        models.LambdaECRConfig (paas-lib). ECR image reference when
        artifact_type is ecr_image.
      required:
        - image_name
        - image_tag
      properties:
        image_name:
          type: string
        image_tag:
          type: string
    LambdaResourceStackInfo:
      type: object
      properties:
        function_arn:
          type: string
        function_name:
          type: string
        runtime:
          $ref: '#/components/schemas/LambdaRuntime'
        layers:
          type: array
          items:
            type: string
    PaasLibErrorCode:
      type: string
      description: >
        Machine-readable code from paas-lib (errors.Code). Matches
        github.com/gapai-io/paas-lib/pkg/errors.Code.
      enum:
        - common.internal_error
        - common.unavailable
        - common.timeout
        - common.conflict
        - common.not_implemented
        - validation.invalid
        - validation.required
        - auth.unauthorized
        - auth.forbidden
        - storage.not_found
        - storage.already_exists
        - storage.db_error
        - storage.constraint_violation
        - service.invalid_state
        - service.rule_violation
        - service.aborted
        - external.error
        - external.timeout
        - external.bad_response
        - stack.manual_deletion
        - subscription.invalid_state
        - subscription.rule_violation
        - subscription.canceled
        - subscription.not_found
        - subscription.limit_reached
      x-enum-varnames:
        - ErrInternalErrorCode
        - ErrUnavailableErrorCode
        - ErrTimeoutErrorCode
        - ErrConflictErrorCode
        - ErrNotImplementedErrorCode
        - ErrValidationInvalidCode
        - ErrValidationRequiredCode
        - ErrUnauthorizedCode
        - ErrForbiddenCode
        - ErrRepoNotFoundErrorCode
        - ErrRepoAlreadyExistsErrorCode
        - ErrRepoDBErrorCode
        - ErrRepoConstraintViolationErrorCode
        - ErrInvalidStateCode
        - ErrBusinessRuleCode
        - ErrOperationAbortCode
        - ErrExternalErrorCode
        - ErrExternalTimeoutCode
        - ErrExternalBadRespCode
        - ErrStackManualDeletionCode
        - ErrSubscriptionInvalidStateCode
        - ErrSubscriptionBusinessRuleCode
        - ErrSubscriptionCanceledCode
        - ErrSubscriptionNotFoundCode
        - ErrSubscriptionLimitReachedCode
    ResourceType:
      type: string
      description: models.ResourceType in paas-lib.
      enum:
        - s3
        - event_bus
        - lambda
        - api_gateway
        - cognito
        - cron
        - dynamodb
        - opensearch
        - pub_sub
        - parameter
        - secrets
        - postgres
        - role
        - ecs_image
    ResourceStatus:
      type: string
      description: models.ResourceStatus (paas-lib).
      enum:
        - DEFINED
        - MODIFIED
        - DEPLOYED
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Bearer token in the Authorization header (e.g. JWT / Cognito access
        token).
    ApiKeyAuth:
      type: apiKey
      name: x-api-key
      in: header
      description: API key in the X-Api-Key header.

````