---
type: resource-type
title: IntegrationResponse
description: aws resource type AWS::ApiGatewayV2::IntegrationResponse
name: IntegrationResponse
lexicon: aws
resource_type: AWS::ApiGatewayV2::IntegrationResponse
---
`AWS::ApiGatewayV2::IntegrationResponse`, a resource type of the aws lexicon.

## Properties

- `ApiId` (`string`, required): The API identifier.
- `IntegrationId` (`string`, required): The integration ID.
- `IntegrationResponseKey` (`string`, required): The integration response key.
- `ContentHandlingStrategy` (`string`, optional): Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are ``CONVERT_TO_BINARY`` and ``CONVERT_TO_TEXT``, with the following behaviors: ``CONVERT_TO_BINARY``: Converts a response payload from a Base64-encoded string to the corresponding binary blob. ``CONVERT_TO_TEXT``: Converts a response payload from a binary blob to a Base64-encoded string. If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
- `IntegrationResponseId` (`string`, optional)
- `ResponseParameters` (`Record<string, unknown>`, optional): A key-value map specifying response parameters that are passed to the method response from the backend. The key is a method response header parameter name and the mapped value is an integration response header value, a static value enclosed within a pair of single quotes, or a JSON expression from the integration response body. The mapping key must match the pattern of ``method.response.header.{name}``, where name is a valid and unique header name. The mapped non-static value must match the pattern of ``integration.response.header.{name}`` or ``integration.response.body.{JSON-expression}``, where ``{name}`` is a valid and unique response header name and ``{JSON-expression}`` is a valid JSON expression without the ``$`` prefix.
- `ResponseTemplates` (`Record<string, unknown>`, optional): The collection of response templates for the integration response as a string-to-string map of key-value pairs. Response templates are represented as a key/value map, with a content-type as the key and a template as the value.
- `TemplateSelectionExpression` (`string`, optional): The template selection expression for the integration response. Supported only for WebSocket APIs.

## Attributes

- `IntegrationResponseId`