---
title: "POST /apps/{appId}/branches/{branchName}/deployments/start"
method: POST
path: "/apps/{appId}/branches/{branchName}/deployments/start"
---

# POST /apps/{appId}/branches/{branchName}/deployments/start

`POST /apps/{appId}/branches/{branchName}/deployments/start`

Starts a deployment for a manually deployed app. Manually deployed apps are not connected to a repository.

## Path parameters

- `appId` string, required
- `branchName` string, required

## Request body

- object
  - `jobId` string — The job ID for this deployment, generated by the create deployment request.
  - `sourceUrl` string — The source URL for this deployment, used when calling start deployment without create deployment. The source URL can be any HTTP GET URL that is publicly accessible and downloads a single .zip file.

## Response `200`

Success

- StartDeploymentResult — The result structure for the start a deployment request.
  - `jobSummary` object, required — The summary for the job.
    - `jobArn` string, required — The Amazon Resource Name (ARN) for the job.
    - `jobId` string, required — The unique ID for the job.
    - `commitId` string, required — The commit ID from a third-party repository provider for the job.
    - `commitMessage` string, required — The commit message from a third-party repository provider for the job.
    - `commitTime` string, date-time, required — The commit date and time for the job.
    - `startTime` string, date-time, required — The start date and time for the job.
    - `status` 'PENDING' | 'PROVISIONING' | 'RUNNING' | 'FAILED' | 'SUCCEED' | 'CANCELLING' | 'CANCELLED', required — The current status for the job.
    - `endTime` string, date-time — The end date and time for the job.
    - `jobType` 'RELEASE' | 'RETRY' | 'MANUAL' | 'WEB_HOOK', required — The type for the job. If the value is <code>RELEASE</code>, the job was manually released from its source by using the <code>StartJob</code> API. If the value is <code>RETRY</code>, the job was manually retried using the <code>StartJob</code> API. If the value is <code>WEB_HOOK</code>, the job was automatically triggered by webhooks.

## Other responses

- `480` — BadRequestException
- `481` — UnauthorizedException
- `482` — InternalFailureException
- `483` — NotFoundException
- `484` — LimitExceededException

---

[API](https://skmtc.net/aws/apis/amplify.md) · [All operations](https://skmtc.net/aws/apis/amplify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/amplify/revisions/573daadbd119/schema)