Automate Environment Administration with the Managed Runtime API

Use the Managed Runtime API to automate the administration tasks in your app. The API offers similar capabilities like the Runtime Admin, in addition to administration options.

• To read environment variables from the storefront, use process.env.
• To read and load redirects use the managed endpoint /mobify/redirects/$path.

To make API requests, you must include an API key in the HTTP request Authorization header with the value, Bearer $API_KEY. To find your API key, log in to the Runtime Admin tool and go to the Account Settings page.

This tutorial uses sample curl requests. Before running the commands, replace any placeholders with actual values. Placeholders are formatted as $PLACEHOLDER. Replace $PROJECT_ID with your actual project ID. To get the project ID, see Find a Project.

Project IDs can be up to 20 characters long and must be unique globally.

Call the projects_target_list API endpoint to list the environments (called “targets” in the API) for a project:

Create a staging environment to verify changes before deploying to production.

Call the projects_target_create API endpoint. If you’re also creating a project, call the projects_create API endpoint to create an environment:

Then call the cc_b2c_target_info_update API endpoint to connect a B2C Commerce instance and one or more sites to the environment.

To use your new environment, deploy a bundle to it.

Call the projects_target_retrieve API endpoint to review the staging environment:

Call the projects_target_partial_update API endpoint to modify the proxy configuration for staging:

Changing the configuration redeploys the deployed bundle so that the configuration update takes effect.

If you’re having trouble using the API, try these troubleshooting steps.

• Add the --fail argument to your curl command.
• Check your API key.
• Check your project’s ID.

The API endpoints also work in a browser. Log in to the Runtime Admin tool, and then open the endpoint in your browser.

To support continuous integration and deployment using the Managed Runtime API, create an Account Manager user for automation:

• Create a user account in Account Manager using a shared email address such as a Google Group. Store the associated credentials and MFA code in a password manager such as LastPass.
• Give the user the Managed Runtime User role.
• Assign the user the required permissions in Runtime Admin. The user’s Managed Runtime API key can only access what the user’s permissions allow. Keep it specific to the projects that CI/CD needs to interact with.
• Create the API key for the user and save it in your continuous integration system.

To keep the Managed Runtime API key active, update the related Account Manager account password as required by your organization’s Account Manager configuration. If the user is deactivated, reset the password to reactivate the account and re-enable the API key.

The Managed Runtime API has rate limits in place for the number of requests allowed per unit of time. Rate limits are applied on a per-user basis, and help ensure fair access for all users.

If your request exceeds a rate limit, the API returns an HTTP 429 Too Many Requests error, and a Retry-After HTTP header that indicates the number of seconds to wait until you can retry. API rate limits can’t be adjusted.

These tables list the rate limits for different API families.

To learn more about the API, see the API Specification.

The Open API schemas for the API are available at:

• MRT Admin: https://cloud.mobify.com/api/schema.json
• MRT B2C Config: https://cloud.mobify.com/api/cc/b2c/schema.json

• Managed Runtime Overview