Skip to end of metadata
Go to start of metadata

API Builder 3.x is deprecated


Support for API Builder 3.x ceased on 30 April 2020. Use the v3 to v4 upgrade guide to migrate all your applications to API Builder 4.x.

Contact if you require migration assistance.

By default, each project includes a configuration file, in JSON format, called appc.json located in the project's top-level folder. The settings in the file tell the Appcelerator CLI and AMPLIFY Runtime Services the nature of the project, which components are required by the project, and any special deployment settings.



The cloud object contains key-value pairs to configure AMPLIFY Runtime Services deployment settings. Instead of running a sequence of appc cloud commands, define the following keys: 

certificateSpecify the path to the custom SSL certificate to use for HTTPS requests.
containerSets the container size to use. Value can either be DevSmallMediumLarge or Xlarge. The default value is Medium. The use of small containers should be avoided. For optimum memory performance, use medium or higher size containers.
domainSet domain binding for the application to the specified domain name. A domain record must exist for the specified domain name, pointing to the application's URL. Do not specify the protocol, that is, do not add http:// or https://, when setting this parameter.
domainPathSpecifies a URL path for routing. Use this parameter when setting more than one application to the same domain name. You must also set the domain key.
environmentAn object containing key-value pairs of environment variables to set for the application, where the key is the variable name and the value is the value to set.
maximumSets the maximum number of server containers that can be used when scaling the application. The default value is 1.
maxqueuesizeSets the maximum number of queued requests for autoscaling to occur. AMPLIFY Runtime Services will increase the number of containers if the queue is too high for at least one minute. The default value is 50.
minimumSets the minimum number of server containers to use. The default value is 1.


The dependencies object contains key-value pairs of components required by the project. The key is the name of the component and the value is the version of the component. By default, API Builder automatically adds the dependencies. You should not need to change the value unless you are removing a component from the project.


The type key is the project type. Values can be apiblockconnector, or model. By default, API Builder sets this property when you generate a new project. You should not need to change the value.