Docs Menu

Docs HomeAtlas App Services

Deploy Changes with Atlas App Services API

On this page

  • Overview
  • Prerequisites
  • Procedure
  • Create a New Draft
  • Make Changes to Your Application
  • Deploy the Draft

You can deploy changes to your App with App Services Admin API by calling relevant HTTP endpoints and then creating and deploying a draft.

A MongoDB Atlas programmatic API key for the MongoDB Cloud account you wish to log in with.


A draft represents a group of application changes that you can deploy or discard as a single unit. To create a draft, send a POST request to the drafts endpoint:

curl --request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <access_token>' \


See also:


One Draft Per User

Each user can only create a single draft at a time, either through the UI or the Admin API. If you already have an existing draft, you can discard the changes associated with it by sending a DELETE request to the draft's endpoint:

curl --request DELETE \
--header 'Authorization: Bearer <access_token>' \

Once you've created a draft, make all of the changes that you want to include in the draft. App Services adds any application changes that you make to the draft so that you can deploy them together.


After you've made all the changes that you want to include in the deployment, deploy the draft by sending a POST request to that draft's deployment endpoint:

curl --request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <access_token>' \


Draft Conflicts

If you deploy changes through the API but have conflicting changes in a draft in the UI, your UI draft will become invalid and you will not be able to deploy it. You can download your UI draft by reviewing the draft in the Deployment page. You can use the download to deploy your changes in the realm-cli or as a reference as you reapply changes in the UI.

←  Deploy Changes with Realm CLIRoll Back Deployments →
Give Feedback
© 2022 MongoDB, Inc.


  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2022 MongoDB, Inc.