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.