---
title: "Initiate deployment"
method: POST
path: "/environments/{environment}/deployments"
tags: ["Deployments"]
---

# Initiate deployment

`POST /environments/{environment}/deployments`

## Request

- Base URL: `https://cloud.laravel.com/api`
- URL: `https://cloud.laravel.com/api/environments/{environment}/deployments`
- Auth: HTTP bearer

Initiate a deployment for the given environment. While the environment's resources are still
provisioning, the deployment is queued instead and a queued deployment is returned with a 202
status and a `Content-Location` header pointing to it.

## Path parameters

- `environment` string, required

## Response `200`

`DeploymentResource`

- object

## Other responses

- `202`: The deployment was queued until the environment's resources are ready.
- `403`: Authorization error
- `404`: Not found
- `422`: Validation error

---

[API](https://skmtc.dev/laravel/apis/laravel-cloud.md) - [All operations](https://skmtc.dev/laravel/apis/laravel-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/laravel/apis/laravel-cloud/revisions/af603f54ff33?raw)