Skip to content

func-api-appconfig-patch

Description

Manages AppConfig configuration for individual Lambda functions. Handles three routes on the Configuration page:

  • PATCH /appconfig/{function_name} — stages a new configuration version. Creates the AppConfig application, environment, and profile automatically if they do not exist. Does not deploy; changes take effect only after POST /appconfig/{function_name}/deploy.
  • POST /appconfig/{function_name}/deploy — deploys the latest staged version using the AppConfig.AllAtOnce strategy. Returns 409 Conflict if a deployment is already in progress.
  • DELETE /appconfig/{function_name} — removes the AppConfig application entirely (all versions, profile, environment, and application), reverting the function to the default WARNING log level. Returns 409 Conflict if a deployment is in progress.

Configuration is stored as a JSON object ({"logging": "WARNING"}) and can carry additional keys for future feature flags. All routes are authenticated via the Cognito JWT authorizer and restricted to super users.

Invocation

Invoked by API Gateway on PATCH, POST, and DELETE requests to /appconfig/{function_name} and /appconfig/{function_name}/deploy.

Sequence Diagrams

PATCH /appconfig/

PATCH Sequence

POST /appconfig/{function_name}/deploy

Deploy Sequence

DELETE /appconfig/

Delete Sequence

API Endpoints

MethodPathDescription
PATCH/appconfig/{function_name}Stage a new configuration version (does not deploy)
POST/appconfig/{function_name}/deployDeploy the latest staged version
DELETE/appconfig/{function_name}Remove the AppConfig application; revert to default WARNING

See the API Reference for full schema documentation.

Deployment

See the deployment workflow documentation for workflow steps, infrastructure dependencies, and failure scenarios.