Amazon AppConfig
AppConfig helps you safely change application behavior in production without redeploying code. Using feature flags and dynamic free-form configurations, you…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
AppConfig helps you safely change application behavior in production without redeploying code. Using feature flags and dynamic free-form configurations, you can control how your application runs in real time. This approach reduces risk, accelerates releases, and enables faster responses to issues. You can gradually roll out new features to specific users, monitor their impact, and expand availability with confidence. You can also update block lists, allow lists, throttling limits, and logging levels instantly, allowing you to mitigate issues and fine-tune performance without a deployment.
AppConfig supports a broad spectrum of use cases:
Feature flags and toggles – Gradually release new capabilities to targeted users, monitor impact, and instantly roll back changes if issues occur.
Application tuning – Introduce changes safely in production, measure their effects, and refine behavior without redeploying code.
Allow list or block list – Control access to features or restrict specific users in real time, without modifying application code.
Centralized configuration storage – Manage configuration data consistently across workloads. AppConfig can deploy configuration from the AppConfig hosted configuration store, Secrets Manager, Systems Manager, Systems Manager Parameter Store, or Amazon S3.
How AppConfig works
This section provides a high-level description of how AppConfig works and how
you get started.
- Identify configuration data to manage in AppConfig
Before creating a configuration profile, identify the configuration data in your code that you want to manage dynamically using AppConfig. Common examples include feature flags, allow and block lists, logging levels, service limits, and throttling rules. These values tend to change frequently and can cause issues if misconfigured.
If your configuration data already exists in cloud services such as Systems Manager Parameter Store or Amazon S3, you can use AppConfig to validate, deploy, and manage that data more effectively.
- Create a configuration profile in AppConfig
A configuration profile defines how AppConfig locates and manages your configuration data. It includes a URI that points to the data source and a profile type.
AppConfig supports two profile types
Feature flags – Enable controlled feature releases, gradual rollouts, and testing in production.
Free-form configurations – Store and retrieve configuration data from external sources and update it without redeploying code.
Both profile types help decouple configuration from code, support continuous delivery, and reduce deployment risk.
You can also add optional validators to ensure that configuration data is syntactically and semantically correct. During deployment, AppConfig evaluates these validators and automatically rolls back changes if validation fails.
Each configuration profile is associated with an application, which acts as a logical container for your configuration resources. For more information about creating a configuration profile, see Creating a configuration profile in AppConfig in the the AppConfig User Guide .
- Deploy configuration data
When you start a deployment, AppConfig:
Retrieves configuration data from the source defined in the configuration profile
Validates the data using the configured validators
Delivers the validated configuration to AppConfig Agent
The delivered configuration becomes the deployed version used by your application. For more information about deploying a configuration, see Deploying feature flags and configuration data in AppConfig .
- Retrieve configuration data
Your application retrieves configuration data by calling a local endpoint exposed by AppConfig Agent, which caches the deployed configuration. Retrieving data is a metered event. AppConfig Agent supports a variety of use cases, as described in How to use AppConfig Agent to retrieve configuration data .
If the agent is not suitable for your use case, your application can retrieve configuration data directly from AppConfig by calling the StartConfigurationSession and GetLatestConfiguration API actions.
For more information about retrieving a configuration, see Retrieving feature flags and configuration data in AppConfig .
This reference is intended to be used with the AppConfig User
Guide .
Endpoints 56
- GETList applications
/applications?max_results=0&next_token=stringLists all applications in your Amazon Web Services account. - POSTCreate application
/applicationsCreates an application. In AppConfig, an application is simply an organizational construct like a folder. This organizational construct has a relationship… - GETList configuration profiles
/applications/:ApplicationId/configurationprofiles?max_results=0&next_token=string&type=stringLists the configuration profiles for an application. - POSTCreate configuration profile
/applications/:ApplicationId/configurationprofilesCreates a configuration profile, which is information that enables AppConfig to access the configuration source. Valid configuration sources include the… - GETList deployment strategies
/deploymentstrategies?max_results=0&next_token=stringLists deployment strategies. - POSTCreate deployment strategy
/deploymentstrategiesCreates a deployment strategy that defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes the… - GETList environments
/applications/:ApplicationId/environments?max_results=0&next_token=stringLists the environments for an application. - POSTCreate environment
/applications/:ApplicationId/environmentsCreates an environment. For each application, you define one or more environments. An environment is a deployment group of AppConfig targets, such as… - POSTCreate experiment definition
/applications/:ApplicationIdentifier/experimentdefinitionsCreates an experiment definition in AppConfig. An experiment definition describes the purpose, scope, and operational configuration of an experiment,… - GETList extensions
/extensions?max_results=0&next_token=string&name=stringLists all custom and Amazon Web Services authored AppConfig extensions in the account. For more information about extensions, see Extending workflows in the… - POSTCreate extension
/extensionsCreates an AppConfig extension. An extension augments your ability to inject logic or behavior at different points during the AppConfig workflow of creating… - GETList extension associations
/extensionassociations?resource_identifier=string&extension_identifier=string&extension_version_number=0&max_results=0&next_token=stringLists all AppConfig extension associations in the account. For more information about extensions and associations, see Extending workflows in the AppConfig… - POSTCreate extension association
/extensionassociationsWhen you create an extension or configure an Amazon Web Services authored extension, you associate the extension with an AppConfig application, environment,… - GETList hosted configuration versions
/applications/:ApplicationId/configurationprofiles/:ConfigurationProfileId/hostedconfigurationversions?max_results=0&next_token=string&version_label=stringLists configurations stored in the AppConfig hosted configuration store by version. - POSTCreate hosted configuration version
/applications/:ApplicationId/configurationprofiles/:ConfigurationProfileId/hostedconfigurationversionsCreates a new configuration in the AppConfig hosted configuration store. If you're creating a feature flag, we recommend you familiarize yourself with the… - GETGet application
/applications/:ApplicationIdRetrieves information about an application. - DELETEDelete application
/applications/:ApplicationIdDeletes an application. - PATCHUpdate application
/applications/:ApplicationIdUpdates an application. - GETGet configuration profile
/applications/:ApplicationId/configurationprofiles/:ConfigurationProfileIdRetrieves information about a configuration profile. - DELETEDelete configuration profile
/applications/:ApplicationId/configurationprofiles/:ConfigurationProfileIdDeletes a configuration profile. To prevent users from unintentionally deleting actively-used configuration profiles, enable deletion protection . - PATCHUpdate configuration profile
/applications/:ApplicationId/configurationprofiles/:ConfigurationProfileIdUpdates a configuration profile. - DELETEDelete deployment strategy
/deployementstrategies/:DeploymentStrategyIdDeletes a deployment strategy. - GETGet environment
/applications/:ApplicationId/environments/:EnvironmentIdRetrieves information about an environment. An environment is a deployment group of AppConfig applications, such as applications in a Production environment… - DELETEDelete environment
/applications/:ApplicationId/environments/:EnvironmentIdDeletes an environment. To prevent users from unintentionally deleting actively-used environments, enable deletion protection . - PATCHUpdate environment
/applications/:ApplicationId/environments/:EnvironmentIdUpdates an environment. - GETGet experiment definition
/applications/:ApplicationIdentifier/experimentdefinitions/:ExperimentDefinitionIdentifierRetrieves information about an experiment definition. - DELETEDelete experiment definition
/applications/:ApplicationIdentifier/experimentdefinitions/:ExperimentDefinitionIdentifier?delete_type=stringDeletes an experiment definition. You can archive the definition to hide it from the active list while preserving it for future reference, or permanently… - PATCHUpdate experiment definition
/applications/:ApplicationIdentifier/experimentdefinitions/:ExperimentDefinitionIdentifierUpdates an experiment definition. You can update treatments, the control, audience rules, and other properties. You cannot update an experiment definition… - GETGet extension
/extensions/:ExtensionIdentifier?version_number=0Returns information about an AppConfig extension. - DELETEDelete extension
/extensions/:ExtensionIdentifier?version=0Deletes an AppConfig extension. You must delete all associations to an extension before you delete the extension. - PATCHUpdate extension
/extensions/:ExtensionIdentifierUpdates an AppConfig extension. For more information about extensions, see Extending workflows in the AppConfig User Guide . - GETGet extension association
/extensionassociations/:ExtensionAssociationIdReturns information about an AppConfig extension association. For more information about extensions and associations, see Extending workflows in the AppConfig… - DELETEDelete extension association
/extensionassociations/:ExtensionAssociationIdDeletes an extension association. This action doesn't delete extensions defined in the association. - PATCHUpdate extension association
/extensionassociations/:ExtensionAssociationIdUpdates an association. For more information about extensions and associations, see Extending workflows in the AppConfig User Guide . - GETGet hosted configuration version
/applications/:ApplicationId/configurationprofiles/:ConfigurationProfileId/hostedconfigurationversions/:VersionNumberRetrieves information about a specific configuration version. - DELETEDelete hosted configuration version
/applications/:ApplicationId/configurationprofiles/:ConfigurationProfileId/hostedconfigurationversions/:VersionNumberDeletes a version of a configuration from the AppConfig hosted configuration store. - GETGet account settings
/settingsReturns information about the status of the DeletionProtection parameter. - PATCHUpdate account settings
/settingsUpdates the value of the DeletionProtection parameter. - GETGet configuration
/applications/:Application/environments/:Environment/configurations/:Configuration?client_id=string&client_configuration_version=stringDeprecated. (Deprecated) Retrieves the latest deployed configuration. Note the following important information. This API action is deprecated. Calls to… - GETGet deployment
/applications/:ApplicationId/environments/:EnvironmentId/deployments/:DeploymentNumberRetrieves information about a configuration deployment. - DELETEStop deployment
/applications/:ApplicationId/environments/:EnvironmentId/deployments/:DeploymentNumberStops a deployment. This API action works only on deployments that have a status of DEPLOYING , unless an AllowRevert parameter is supplied. If the… - GETGet deployment strategy
/deploymentstrategies/:DeploymentStrategyIdRetrieves information about a deployment strategy. A deployment strategy defines important criteria for rolling out your configuration to the designated… - PATCHUpdate deployment strategy
/deploymentstrategies/:DeploymentStrategyIdUpdates a deployment strategy. - GETGet experiment run
/applications/:ApplicationIdentifier/experimentdefinitions/:ExperimentDefinitionIdentifier/experimentruns/:RunRetrieves information about an experiment run, including its status, start time, and exposure settings. - GETList deployments
/applications/:ApplicationId/environments/:EnvironmentId/deployments?max_results=0&next_token=stringLists the deployments for an environment in descending deployment number order. - POSTStart deployment
/applications/:ApplicationId/environments/:EnvironmentId/deploymentsStarts a deployment. AppConfig Agent supports deploying feature flag or free-form configuration data to specific segments or individual users during a gradual… - GETList experiment definitions
/experimentdefinitions?application_identifier=string&configuration_profile_identifier=string&environment_identifier=string&status=string&max_results=0&next_token=stringLists the experiment definitions for an account. You can filter results by application, configuration profile, environment, or status. - GETList experiment run events
/applications/:ApplicationIdentifier/experimentdefinitions/:ExperimentDefinitionIdentifier/experimentruns/:Run/events?max_results=0&next_token=stringLists the events for a specified experiment run. Events provide a timeline of actions and state changes that occurred during the run. - GETList experiment runs
/applications/:ApplicationIdentifier/experimentdefinitions/:ExperimentDefinitionIdentifier/experimentruns?max_results=0&next_token=string&status=stringLists the experiment runs for a specified experiment definition. You can filter by status. - POSTStart experiment run
/applications/:ApplicationIdentifier/experimentdefinitions/:ExperimentDefinitionIdentifier/experimentrunsStarts an experiment run for the specified experiment definition. An experiment run delivers treatments to the target audience and collects metrics. You can… - GETList tags for resource
/tags/:ResourceArnRetrieves the list of key-value tags assigned to the resource. - POSTTag resource
/tags/:ResourceArnAssigns metadata to an AppConfig resource. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both… - DELETEUntag resource
/tags/:ResourceArn?tagKeys=Deletes a tag key and value from an AppConfig resource. - PATCHStop experiment run
/applications/:ApplicationIdentifier/experimentdefinitions/:ExperimentDefinitionIdentifier/experimentruns/:Run/stopStops a running experiment. Stopping an experiment run ends audience exposure and returns users to the currently deployed feature flag configuration. - PATCHUpdate experiment run
/applications/:ApplicationIdentifier/experimentdefinitions/:ExperimentDefinitionIdentifier/experimentruns/:Run/updateUpdates a running experiment. Use this operation to increase audience exposure, modify treatment assignment overrides, or update the description of an active… - POSTValidate configuration
/applications/:ApplicationId/configurationprofiles/:ConfigurationProfileId/validators?configuration_version=stringUses the validators in a configuration profile to validate a configuration.
API details
- Base URL
https://appconfig.{region}.amazonaws.com- Authentication
- AWS Signature Version 4 (requests signed with your AWS access key)
- Operations
- 56 operations on 29 pathsGET 24POST 12PATCH 10DELETE 10
1 marked deprecated - Description format
- AWS Smithy model, API version
2019-10-09 - Links
- Documentation · OpenAPI document
- Listed from
- AWS Smithy API model (aws/api-models-aws) (Apache-2.0)
How to test the Amazon AppConfig in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Amazon AppConfig collection, without the publisher's secrets.
- Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List applications” (GET /applications?max_results=0&next_token=string), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Amazon AppConfig?
AppConfig helps you safely change application behavior in production without redeploying code. Using feature flags and dynamic free-form configurations, you… It is listed under Developer tools and has 56 endpoints.
Who publishes the Amazon AppConfig?
It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Amazon AppConfig?
Requests go to https://appconfig.{region}.amazonaws.com. Endpoint paths are added to this base URL.
How do I authenticate with the Amazon AppConfig?
With AWS Signature Version 4 (requests signed with your AWS access key).
How many endpoints does the Amazon AppConfig have?
56 operations on 29 paths (24 GET, 12 POST, 10 PATCH, 10 DELETE).
Is forking the Amazon AppConfig free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.