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

# Deployment API

> Create releases and deploy them to project environments.

Create releases and deploy them to project environments.

Configure domains, environment variables, and servers. Manage release asset manifests and inspect deployment records.

[Releases](#releases) · [Release Versions](#release-versions) · [Release Source Manifests](#release-source-manifests) · [Release Asset Manifests](#release-asset-manifests) · [Environments](#environments) · [Project deployments](#project-deployments) · [Project Domains](#project-domains) · [Environment Domains](#environment-domains) · [Environment Variable Keys](#environment-variable-keys) · [Environment variables](#environment-variables) · [Project servers](#project-servers) · [Environment Servers](#environment-servers) · [Proxy metadata](#proxy-metadata)

## Releases

Create, read, delete, or find project releases.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/releases` | [GET](/docs/cloud/rest/api-reference/releases/list-releases), [POST](/docs/cloud/rest/api-reference/releases/create-release) | List releases; Create release |
| `/projects/{project_reference}/releases/{release_id}` | [GET](/docs/cloud/rest/api-reference/releases/get-release), [DELETE](/docs/cloud/rest/api-reference/releases/delete-release) | Get release; Delete release |
| `/projects/{project_reference}/releases/latest` | [GET](/docs/cloud/rest/api-reference/releases/get-latest-release) | Get latest release |
| `/projects/{project_reference}/releases/version/{version_spec}` | [GET](/docs/cloud/rest/api-reference/releases/get-release-by-version) | Get release by version |

## Release Versions

List the versions recorded for a release.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/releases/{release_id}/versions` | [GET](/docs/cloud/rest/api-reference/release-versions/list-release-versions) | List release versions |

## Release Source Manifests

Export the source manifest for a release.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/releases/{release_id}/source-manifest` | [GET](/docs/cloud/rest/api-reference/release-source-manifests/export-exact-release-source) | Export exact release source |

## Release Asset Manifests

Read, write, build, or update release asset manifests.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/releases/{version}/asset-manifest` | [GET](/docs/cloud/rest/api-reference/release-asset-manifests/get-release-asset-manifest), [PUT](/docs/cloud/rest/api-reference/release-asset-manifests/put-release-asset-manifest) | Get release asset manifest; Put release asset manifest |
| `/projects/{project_reference}/releases/{version}/asset-manifest/assets` | [POST](/docs/cloud/rest/api-reference/release-asset-manifests/upload-release-asset) | Upload release asset |
| `/projects/{project_reference}/releases/{version}/asset-manifest/builds` | [POST](/docs/cloud/rest/api-reference/release-asset-manifests/begin-release-asset-manifest-build) | Begin release asset manifest build |
| `/projects/{project_reference}/releases/{version}/asset-manifest/state` | [POST](/docs/cloud/rest/api-reference/release-asset-manifests/report-release-asset-manifest-state) | Report release asset manifest state |

## Environments

Create and manage deployment environments. Use the environment ID when configuring [deployments](/docs/cloud/rest/apis/deployment-api#project-deployments), [domains](/docs/cloud/rest/apis/deployment-api#environment-domains), [variables](/docs/cloud/rest/apis/deployment-api#environment-variables), or [servers](/docs/cloud/rest/apis/deployment-api#environment-servers).

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/environments` | [GET](/docs/cloud/rest/api-reference/environments/list-environments), [POST](/docs/cloud/rest/api-reference/environments/create-environment) | List environments; Create environment |
| `/projects/{project_reference}/environments/{environment_id}` | [GET](/docs/cloud/rest/api-reference/environments/get-environment), [PATCH](/docs/cloud/rest/api-reference/environments/update-environment), [DELETE](/docs/cloud/rest/api-reference/environments/delete-environment) | Get environment; Update environment; Delete environment |

## Project deployments

Deploy a release to an environment. Read deployment records to inspect the resulting configuration. Investigate application behavior through [project logs](/docs/cloud/rest/apis/observability-api#project-logs).

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/deployments` | [GET](/docs/cloud/rest/api-reference/project-deployments/list-deployments), [POST](/docs/cloud/rest/api-reference/project-deployments/create-deployment) | List deployments; Create deployment |
| `/projects/{project_reference}/deployments/{deployment_id}` | [GET](/docs/cloud/rest/api-reference/project-deployments/get-deployment), [PATCH](/docs/cloud/rest/api-reference/project-deployments/update-deployment), [DELETE](/docs/cloud/rest/api-reference/project-deployments/delete-deployment) | Get deployment; Update deployment; Delete deployment |

## Project Domains

List domains across a project.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/domains` | [GET](/docs/cloud/rest/api-reference/project-domains/list-project-domains) | List project domains |

## Environment Domains

Create, read, update, or delete domains for an environment.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/environments/{environment_id}/domains` | [GET](/docs/cloud/rest/api-reference/environment-domains/list-domains), [POST](/docs/cloud/rest/api-reference/environment-domains/create-domain) | List domains; Create domain |
| `/projects/{project_reference}/environments/{environment_id}/domains/{domain_reference}` | [GET](/docs/cloud/rest/api-reference/environment-domains/get-domain), [PATCH](/docs/cloud/rest/api-reference/environment-domains/update-domain), [DELETE](/docs/cloud/rest/api-reference/environment-domains/delete-domain) | Get domain; Update domain; Delete domain |

## Environment Variable Keys

List environment variable keys without values.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/environment-variable-keys` | [GET](/docs/cloud/rest/api-reference/environment-variable-keys/list-environment-variable-keys) | List environment variable keys |

## Environment variables

List, create, read, update, or delete environment variables.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/environment-variables` | [GET](/docs/cloud/rest/api-reference/environment-variables/list-environment-variables), [POST](/docs/cloud/rest/api-reference/environment-variables/create-environment-variable) | List environment variables; Create environment variable |
| `/projects/{project_reference}/environment-variables/{key}` | [GET](/docs/cloud/rest/api-reference/environment-variables/get-environment-variable), [PATCH](/docs/cloud/rest/api-reference/environment-variables/update-environment-variable), [DELETE](/docs/cloud/rest/api-reference/environment-variables/delete-environment-variable) | Get environment variable; Update environment variable; Delete environment variable |

## Project servers

List, read, or delete project server records.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/servers` | [GET](/docs/cloud/rest/api-reference/project-servers/list-project-servers) | List project servers |
| `/projects/{project_reference}/servers/{server_id}` | [GET](/docs/cloud/rest/api-reference/project-servers/get-project-server), [DELETE](/docs/cloud/rest/api-reference/project-servers/delete-project-server) | Get project server; Delete project server |

## Environment Servers

Create a server for an environment.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/environments/{environment_id}/servers` | [POST](/docs/cloud/rest/api-reference/environment-servers/create-project-server) | Create project server |

## Proxy metadata

Read routing or access metadata for proxy requests. These endpoints have separate freshness and authorization requirements.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/-/proxy-access/{lookup_key}` | [GET](/docs/cloud/rest/api-reference/proxy-metadata/get-proxy-access-metadata) | Get proxy access metadata |
| `/projects/-/proxy-routing/{lookup_key}` | [GET](/docs/cloud/rest/api-reference/proxy-metadata/get-proxy-routing-metadata) | Get proxy routing metadata |

[Back to REST API reference](/docs/cloud/rest)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.