> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voiceflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Publishing overview

> Ship changes with environments. Edit a draft, publish it live, clone one to work in isolation, merge it back, and split traffic between versions.

An environment is a copy of your agent with its own draft and its own live
version. Publishing promotes the draft; until you do, nothing you change
reaches users.

These endpoints let you work in an environment of your own, merge it back when
it is ready, and route a share of real traffic to it to compare two versions
against each other.

## Endpoints

### Environment

| Endpoint                                                                                                            | Description                                                  |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| <Badge color="green" size="sm">GET</Badge> [List environments](/api-reference/environment/list-environments)        | List all environments by project ID.                         |
| <Badge color="purple" size="sm">PUT</Badge> [Merge environments](/api-reference/environment/merge-environments)     | Merge one environment into another.                          |
| <Badge color="purple" size="sm">PUT</Badge> [Update traffic split](/api-reference/environment/update-traffic-split) | Update the percentage of traffic routed to each environment. |
| <Badge color="green" size="sm">GET</Badge> [Get environment](/api-reference/environment/get-environment)            | Get an environment by alias or ID.                           |
| <Badge color="orange" size="sm">PATCH</Badge> [Update environment](/api-reference/environment/update-environment)   | Update a environment by alias or ID.                         |
| <Badge color="red" size="sm">DELETE</Badge> [Delete environment](/api-reference/environment/delete-environment)     | Delete an environment by alias or ID.                        |
| <Badge color="green" size="sm">GET</Badge> [Export environment](/api-reference/environment/export-environment)      | Export all data from environment.                            |
| <Badge color="purple" size="sm">PUT</Badge> [Compile environment](/api-reference/environment/compile-environment)   | Compile an environment.                                      |
| <Badge color="blue" size="sm">POST</Badge> [Clone environment](/api-reference/environment/clone-environment)        | Clone an environment.                                        |
| <Badge color="blue" size="sm">POST</Badge> [Publish environment](/api-reference/environment/publish-environment)    | Publish live version of an environment.                      |