Skip to main content
POST
/
project
/
{projectId}
/
environment
Create an environment
curl --request POST \
  --url https://api.qovery.com/project/{projectId}/environment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cluster": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "mode": "PRODUCTION"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "organization": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "project": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "cloud_provider": {
    "provider": "aws",
    "cluster": "us-east-2"
  },
  "mode": "PRODUCTION",
  "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updated_at": "2023-11-07T05:31:56Z",
  "last_updated_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "cluster_name": "<string>"
}

Authorizations

​
Authorization
string
header
required

JWT tokens should be used with OIDC account (human to machine). JWT tokens used by the Qovery console to communicate with the API have a TTL. Curl Example ' curl https://console.qovery.com/organization -H "Authorization: Bearer $qovery_token" '

Path Parameters

​
projectId
string<uuid>
required

Project ID

Body

application/json
​
name
string
required

name is case insensitive

​
cluster
string<uuid>
​
mode
enum<string>
Available options:
DEVELOPMENT,
PRODUCTION,
STAGING
Example:

"PRODUCTION"

Response

Create environment

​
id
string<uuid>
required
​
created_at
string<date-time>
required
​
name
string
required

name is case insensitive

​
organization
object
required
​
project
object
required
​
cloud_provider
object
required
​
mode
enum<string>
required
Available options:
DEVELOPMENT,
PREVIEW,
PRODUCTION,
STAGING
Example:

"PRODUCTION"

​
cluster_id
string<uuid>
required
​
updated_at
string<date-time>
​
last_updated_by
string<uuid>

uuid of the user that made the last update

​
cluster_name
string<string>