---
title: "Publish environment"
method: POST
path: "/v1alpha1/project/{projectID}/environment/{projectEnvironmentIDorAlias}/publish"
tags: ["EnvironmentPublicApi", "Public-Docs"]
---

# Publish environment

`POST /v1alpha1/project/{projectID}/environment/{projectEnvironmentIDorAlias}/publish`

Publish the target environment's draft as its new published version. The environment can be targeted by ID or alias.

## Path parameters

- `projectID` string, required
- `projectEnvironmentIDorAlias` string, required

## Request body

- PublishProjectEnvironmentRequest
  - `name` string, required
  - `description` string, nullable, required

## Response `201`

The updated environment and created release.

- ProjectEnvironmentPublishResponse
  - `data` object, required
    - `projectEnvironment` ProjectEnvironment, required
      - `id` string, required
      - `name` string, required
      - `alias` string, required
      - `isMain` boolean, required
      - `releases` ProjectEnvironmentRelease[], required
        - `name` string, required
        - `backupID` number, required
        - `createdAt` string, required
        - `versionID` string, required
        - `description` string, nullable, required
        - `autogenerated` boolean, required
        - `createdByUserID` number, nullable, required
      - `createdAt` string, required
      - `draftVersionID` string, required
      - `createdByUserID` number, required
      - `clonedFromMainAt` string, nullable
      - `trafficPercentage` number, required
      - `nextReleaseNumber` number, required
      - `publishedVersionID` string, required
      - `draftVersionIDsHistory` string[], required
    - `projectEnvironmentRelease` ProjectEnvironmentRelease, required
      - `name` string, required
      - `backupID` number, required
      - `createdAt` string, required
      - `versionID` string, required
      - `description` string, nullable, required
      - `autogenerated` boolean, required
      - `createdByUserID` number, nullable, required

---

[API](https://skmtc.dev/voiceflow/apis/general-runtime.md) · [All operations](https://skmtc.dev/voiceflow/apis/general-runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voiceflow/general-runtime/revisions/6b1c4f778c56/schema)