---
title: "Deploy a deployment draft"
method: POST
path: "/groups/{groupId}/apps/{appId}/drafts/{draftId}/deployment"
tags: ["deploy"]
---

# Deploy a deployment draft

`POST /groups/{groupId}/apps/{appId}/drafts/{draftId}/deployment`

Deploy the specified application deployment draft.

## Request body

- object
  - `name` string, required — The name of the deployment. To deploy a draft without a name, use an empty string.

## Response `201`

The draft was successfully deployed.

- Deployment
  - `_id` string — The unique ID of the deployment.
  - `name` string — The name of the deployment. By default, this is the same value as ``_id``.
  - `app_id` string — The unique `_id` value of the Atlas App Services App.
  - `draft_id` string — The unique `_id` value of the deployment draft associated with the deployment, if applicable.
  - `user_id` string — The unique `_id` value of the MongoDB Cloud user that deployed the draft.
  - `deployed_at` integer — The time at which the deployment was made. Represented as the number of seconds since January 1, 1970.
  - `origin` string — The deployment method used to create the deployment.
  - `commit` string — The commit hash of the deployment (Automatic GitHub Deployment)
  - `status` string — A message that indicates whether or not the deployment was successful.
  - `status_error_message` string — The error message of the error that caused the deployment to fail, if applicable.
  - `diff_url` string — A link to the diff of changes in the deployment
  - `remote_location` 'US-VA' | 'US-OR' | 'DE-FF' | 'IE' | 'AU' | 'IN-MB' | 'SG' | 'BR-SP' — An identifier of the location where an app server is physically deployed to, regardless of the cloud provider that hosts the app.

---

[API](https://skmtc.net/mongodb/apis/mongodb-atlas-app-services-admin-api.md) · [All operations](https://skmtc.net/mongodb/apis/mongodb-atlas-app-services-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mongodb/mongodb-atlas-app-services-admin-api/revisions/1365ab72bc03/schema)