---
title: "Update deployment"
method: PATCH
path: "/deployments/{deployment_name}"
tags: ["Deployments"]
---

# Update deployment

`PATCH /deployments/{deployment_name}`

Updates properties of an existing deployment. Only the fields provided in
the request body are modified; omitted fields are left unchanged.

## Path parameters

- `deployment_name` string, required

## Request body

- PlatformUpdateDeploymentArgs
  - `reference` string, nullable — The reference of the deployment. When provided, must match the following rules: - be unique across deployment references in the project - 3 to 100 characters (included) - only lowercase letters, numbers, "-"" and "/" - not follow the deployment name format [a-z]+-[a-z]+-[0-9]+ (e.g. "happy-capybara-123") - not start with "local-"" - not be one of the following reserved keywords: "prod", "dev", "cloud", "local", "default", "name", "new", "existing", "deployment", "preview"
  - `dashboardEditConfirmation` boolean, nullable — Controls whether the dashboard requires a confirmation before allowing edits during a browser session for this deployment. If set to `null`, the setting is reset to the default behavior (true for prod deployments, false for dev and preview deployments). If set to `true` or `false`, the setting is explicitly overridden.
  - `expiresAt` integer, nullable — Timestamp in milliseconds when this deployment will be deleted. Preview deployments have this set by default unless overridden. Must be at least 30 minutes in the future and cannot exceed the team's preview deployment retention days entitlement from now. Set to `null` to clear the expiration.
  - `sendLogsToClient` boolean, nullable — Whether to send function logs to the client. If set to `null`, the setting is reset to the deployment-type default (true for dev/preview, false for prod). If set to `true` or `false`, the setting is explicitly overridden.
  - `class` string, nullable — The deployment class to move this deployment to (e.g. "s16", "s256"). Requires the deployment class selection entitlement.
  - `isDefault` boolean, nullable — For a prod deployment, whether the deployment is the default production deployment for the project (i.e. the one used by default when running `npx convex deploy`). For a dev deployment, whether the deployment is the default development deployment for the member that created it (i.e. the one used by default when running `npx convex dev`). Setting this to `true` will fail on preview or custom deployments, or if there is already a matching default deployment in the project.
  - `deploymentType` 'dev' | 'prod' | 'preview' | 'custom'

## Response `200`

---

[API](https://skmtc.dev/convex/apis/convex-management-api.md) · [All operations](https://skmtc.dev/convex/apis/convex-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/convex/convex-management-api/revisions/3dd5e601c536/schema)