---
title: "Create Deployment"
method: POST
path: "/deployments"
tags: ["deployments"]
---

# Create Deployment

`POST /deployments`

Create a new deployment for a specific chat and version. This will trigger a deployment to Vercel.

## Request body

- object
  - `projectId` string, required
  - `chatId` string, required
  - `versionId` string, required

## Response `200`

Success

- DeploymentDetail
  - `id` string, required — A unique identifier for the deployment.
  - `object` 'deployment', required — Fixed value identifying this object as a deployment.
  - `inspectorUrl` string, required — URL to the deployment inspector.
  - `chatId` string, required — The ID of the chat that this deployment is scoped to.
  - `projectId` string, required — The ID of the project that this deployment is scoped to.
  - `versionId` string, required — The ID of the version that this deployment is scoped to.
  - `apiUrl` string, uri, required — The API endpoint URL for accessing this deployment programmatically.
  - `webUrl` string, uri, required — The web URL where the deployment can be viewed or managed.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `413` — Payload Too Large
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2025-08-24** `3521652a43a7` — 1 breaking, 1 info
  - the request property `projectId` became required
  - the response property `projectId` became required for the status `200`

[Change history](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/deployments/post.md)

---

[API](https://skmtc.dev/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.dev/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/revisions/e9f83fb57a16/schema)