Sign in

v14

latestOpenAPI 3.0.32026-08-04377889.4 MB
environment

Create a custom environment for the current project.

Creates a custom environment for the current project. Cannot be named 'Production' or 'Preview'.

post/v9/projects/{idOrName}/custom-environments

Path parameters

idOrNamestring required

The unique project identifier or the project name

The unique project identifier or the project name

Query parameters

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Request body

slugstring

The slug of the custom environment to create.

descriptionstring

Description of the custom environment. This is optional.

copyEnvVarsFromstring

Where to copy environment variables from. This is optional.

Response

idstring required

Unique identifier for the custom environment (format: env_*)

slugstring required

URL-friendly name of the environment

type'development' | 'preview' | 'production' required

The type of environment (production, preview, or development)

descriptionstring

Optional description of the environment's purpose

currentDeploymentAliasesstring[]

List of aliases for the current deployment

createdAtnumber required

Timestamp when the environment was created

updatedAtnumber required

Timestamp when the environment was last updated