HttpApiLambdaMultiRoute

Defined in: packages/core/src/types/lambda.ts:330

Multi-route (“fat lambda”) HTTP API v2 config — one warm fn, N routes (D1/D8).

Extends

• BaseLambdaConfig

Properties

architecture?

optional architecture?: LambdaArchitecture

Defined in: packages/core/src/types/lambda.ts:130

CPU architecture. Defaults to arm64 (Graviton — cheaper + faster for most workloads). Lambda@Edge MUST use x86_64.

Inherited from

BaseLambdaConfig.architecture

---

authorizer?

optional authorizer?: HttpApiAuthorizer

Defined in: packages/core/src/types/lambda.ts:335

Optional fallback authorizer for routes that omit their own (D4).

---

basePath?

optional basePath?: string

Defined in: packages/core/src/types/lambda.ts:337

Optional path prefix; routes are relative when set (D9). Must start with ”/“.

---

bundling?

optional bundling?: NodejsBundlingConfig | PythonBundlingConfig | GoBundlingConfig

Defined in: packages/core/src/types/lambda.ts:191

Runtime-specific bundling config

Inherited from

BaseLambdaConfig.bundling

---

constructId?

optional constructId?: string

Defined in: packages/core/src/types/lambda.ts:145

CloudFormation logical ID override. Use when migrating existing lambdas to preserve physical resource IDs.

Inherited from

BaseLambdaConfig.constructId

---

customFunctionName?

optional customFunctionName?: (appName, stageName) => string

Defined in: packages/core/src/types/lambda.ts:151

Custom function name factory. If omitted, the framework generates: ${appName}-${name}-${stageName}

Parameters

appName

string

stageName

string

Returns

string

Inherited from

BaseLambdaConfig.customFunctionName

---

description

description: string

Defined in: packages/core/src/types/lambda.ts:133

Human-readable description (shows in AWS console)

Inherited from

BaseLambdaConfig.description

---

enableTracing?

optional enableTracing?: boolean

Defined in: packages/core/src/types/lambda.ts:157

Enable X-Ray tracing. Default: true. Not supported on Lambda@Edge.

Inherited from

BaseLambdaConfig.enableTracing

---

entry

entry: string

Defined in: packages/core/src/types/lambda.ts:112

Handler entry point, relative to the project root. Node.js: path to .ts file (e.g. “lambdas/modules/url/api/create/index.ts”) Python: path to .py file (e.g. “lambdas/url/create.py”) Go: path to package (e.g. “lambdas/url/create”)

Inherited from

BaseLambdaConfig.entry

---

environment?

optional environment?: Record<string, string>

Defined in: packages/core/src/types/lambda.ts:182

Environment variables. Supports {{token}} syntax for registry values and ${ssm:/path} for SSM parameters.

Note: Lambda@Edge does not support environment variables. For edge lambdas, use bundling.define instead.

Inherited from

BaseLambdaConfig.environment

---

kind

kind: "httpapi"

Defined in: packages/core/src/types/lambda.ts:331

Execution context.

Overrides

BaseLambdaConfig.kind

---

logLevel?

optional logLevel?: "ERROR" | "DEBUG" | "INFO" | "WARN" | "SILENT"

Defined in: packages/core/src/types/lambda.ts:154

Powertools log level. Default: INFO

Inherited from

BaseLambdaConfig.logLevel

---

logRetentionDays?

optional logRetentionDays?: number

Defined in: packages/core/src/types/lambda.ts:173

CloudWatch log group retention in days for this lambda. Overrides the project-wide default from lambdaDefaults.logRetentionDays.

Framework defaults (when not set here or in lambdaDefaults):

• dev: 30 days
• prod: 90 days

Set to 0 to disable retention (logs kept forever — not recommended in prod). Not supported on Lambda@Edge (edge functions use CloudFront logging).

Inherited from

BaseLambdaConfig.logRetentionDays

---

logSensitive?

optional logSensitive?: "true" | "false"

Defined in: packages/core/src/types/lambda.ts:160

Set to “true” to include sensitive fields in logs (non-prod only)

Inherited from

BaseLambdaConfig.logSensitive

---

memorySize?

optional memorySize?: number

Defined in: packages/core/src/types/lambda.ts:136

Memory in MB. Default: 512

Inherited from

BaseLambdaConfig.memorySize

---

method?

optional method?: never

Defined in: packages/core/src/types/lambda.ts:338

---

name

name: string

Defined in: packages/core/src/types/lambda.ts:99

Unique name for this lambda. Used in function names and logical IDs. Convention: kebab-case, e.g. “create-url”, “process-payment”

Inherited from

BaseLambdaConfig.name

---

path?

optional path?: never

Defined in: packages/core/src/types/lambda.ts:339

---

permissionsSpec?

optional permissionsSpec?: PermissionSpec[]

Defined in: packages/core/src/types/lambda.ts:188

Declarative IAM permissions. The constructs package translates these into PolicyStatements.

Inherited from

BaseLambdaConfig.permissionsSpec

---

routes

routes: HttpApiRoute[]

Defined in: packages/core/src/types/lambda.ts:333

One or more routes attached to a single warm function. Must be non-empty.

---

runtime?

optional runtime?: LambdaRuntime

Defined in: packages/core/src/types/lambda.ts:124

Lambda runtime. Defaults to nodejs24 (latest LTS).

Examples: “nodejs24” → Node.js 24.x (latest) “nodejs22” → Node.js 22.x (LTS — EOL April 2027) “python312” → Python 3.12 “python311” → Python 3.11 “go” → Go on provided.al2023

Inherited from

BaseLambdaConfig.runtime

---

timeoutSeconds?

optional timeoutSeconds?: number

Defined in: packages/core/src/types/lambda.ts:139

Timeout in seconds. Default: 10

Inherited from

BaseLambdaConfig.timeoutSeconds