Adding the x-yc-apigateway-integration:serverless_containers extension
Written by
Updated at August 10, 2026
Management console
-
In the management console
, select the folder in which you created or want to create an API gateway. -
Navigate
to API Gateway. -
Select an API gateway or click Create API gateway to create a new one.
-
Click
Edit. -
In the Specification field, click
. -
Specify the following fields:
- Path: Integration relative path to add to the API Gateway URL. Remember to wrap variables in braces, e.g.,
/static/{function_id}. For more information, see the OpenAPI 3.0 specification. - HTTP method: Method to use to work with the integration.
- Optionally, Service account: Service account for authorization when accessing a container. If you do not have a service account, create one.
- Container: Container ID. To find out the ID, get information about the container.
- Path: Integration relative path to add to the API Gateway URL. Remember to wrap variables in braces, e.g.,
-
Optionally, paste or upload operation context, i.e., any object in YAML or JSON format. It is encoded in Base64 and provided to the container in the
X-Yc-ApiGateway-Operation-Contextheader. The operation context supports parameter substitution. -
Click Add.
The Specification field will display the OpenAPI specification with the specified parameter values.