{
  "openapi": "3.1.0",
  "info": {
    "title": "Hello World API",
    "description": "Reference serverless API built on AWS Lambda Powertools, deployed behind\nAPI Gateway, CloudFront, and AWS WAF.\n\nThe spec on this page is generated at documentation-build time from the\nlive Pydantic models and route decorators in `lambda/app.py`. Any change\nto a route, a request body model, or a return-type annotation appears\nhere on the next `make docs` run.\n\nEach operation carries an `x-amazon-apigateway-integration` block showing\nthe AWS_PROXY integration with Lambda that the CDK stack provisions. The\nURI uses literal `{region}` and `{lambdaArn}` placeholders \u2014 the deployed\nAPI is built by CDK, not imported from this file, so readers can substitute\nthose if they want to `aws apigateway import-rest-api` the spec elsewhere.\n",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://{apiId}.execute-api.{region}.amazonaws.com/prod",
      "description": "API Gateway stage (substitute your deployed apiId and region)"
    }
  ],
  "paths": {
    "/hello": {
      "get": {
        "tags": [
          "Greeting"
        ],
        "summary": "Return a greeting",
        "description": "Returns the greeting string configured in SSM Parameter Store. When the `enhanced_greeting` AppConfig feature flag is enabled for the caller's source IP, the response includes the feature flag's configured suffix.",
        "operationId": "hello_hello_get",
        "responses": {
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "200": {
            "description": "A JSON object containing the resolved greeting.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HelloResponse"
                }
              }
            }
          }
        },
        "x-amazon-apigateway-integration": {
          "type": "aws_proxy",
          "httpMethod": "POST",
          "uri": "arn:aws:apigateway:{region}:lambda:path/2015-03-31/functions/{lambdaArn}/invocations",
          "passthroughBehavior": "when_no_match"
        }
      }
    }
  },
  "components": {
    "schemas": {
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "HelloResponse": {
        "properties": {
          "message": {
            "type": "string",
            "title": "Message",
            "description": "Greeting from SSM Parameter Store, optionally suffixed when the enhanced_greeting flag is on.",
            "examples": [
              "hello world",
              "hello world - enhanced mode enabled"
            ]
          }
        },
        "type": "object",
        "required": [
          "message"
        ],
        "title": "HelloResponse",
        "description": "Response body for GET /hello."
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      },
      "ResponseValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "ResponseValidationError"
      }
    }
  },
  "tags": [
    {
      "name": "Greeting",
      "description": "Endpoints that return the configured greeting."
    }
  ]
}