# HttpRouteProps

Properties to initialize a new Route.

Extends: HttpRouteProps
Extends: BatchHttpRouteOptions
Used as props by: HttpRoute

- Source: [`aws-apigatewayv2/lib/http/route.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-apigatewayv2/lib/http/route.ts#L133)
- Type last changed: v2.235.0 · 15 Jan 2026

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_apigatewayv2 as apigatewayv2 } from 'aws-cdk-lib';

declare const httpApiRef: apigatewayv2.IHttpApiRef;
declare const httpRouteAuthorizer: apigatewayv2.IHttpRouteAuthorizer;
declare const httpRouteIntegration: apigatewayv2.HttpRouteIntegration;
declare const httpRouteKey: apigatewayv2.HttpRouteKey;
const httpRouteProps: apigatewayv2.HttpRouteProps = {
  httpApi: httpApiRef,
  integration: httpRouteIntegration,
  routeKey: httpRouteKey,

  // the properties below are optional
  authorizationScopes: ['authorizationScopes'],
  authorizer: httpRouteAuthorizer,
};
```

## Properties

- `authorizationScopes`: string[] — The list of OIDC scopes to include in the authorization.

  **Default:** no additional authorization scopes

  These scopes will be merged with the scopes from the attached authorizer

- `authorizer`: [IHttpRouteAuthorizer](/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.IHttpRouteAuthorizer.html) — Authorizer for a WebSocket API or an HTTP API.

  **Default:** No authorizer

- `httpApi`: [IHttpApiRef](/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.IHttpApiRef.html) (required) — the API the route is associated with.

- `integration`: [HttpRouteIntegration](/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.HttpRouteIntegration.html) (required) — The integration to be configured on this route.

- `routeKey`: [HttpRouteKey](/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.HttpRouteKey.html) (required) — The key to this route.

  This is a combination of an HTTP method and an HTTP path.