Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Qovery Environments API

The Environments API from Qovery — 4 operation(s) for environments.

Qovery Environments API is one of 94 APIs that Qovery publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Environments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, an API reference, authentication docs, and rate-limit docs.

This API exposes 5 operations across 4 paths, and defines 24 schemas. It is described by OpenAPI 3.0.0, at version 1.0.4.

Requests are made against a single base URL, https://api.qovery.com.

5 operations 4 paths 24 schemas 4 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.4
Base URL
https://api.qovery.com
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Qovery Environments API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). An API key is passed in the header as Authorization (ApiKeyAuth). By default, every request must be authenticated.

  • bearerAuth — 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 ' cu…
  • ApiKeyAuth — Token API are generated by Qovery to manage machine to machine interaction and do not have a TTL. Curl Example ' curl https://console.qovery.com/organization -…

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 4 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Environments 5
GET
/project/{projectId}/environment
List environments
listEnvironment 1 param → 200401403404
POST
/project/{projectId}/environment
Create an environment
createEnvironment 1 param body → 201400401403404409
GET
/project/{projectId}/environment/status
List environments statuses
getProjectEnvironmentsStatus 1 param → 200401403404
GET
/project/{projectId}/environment/stats
List total number of services for each environment of the project
getProjectEnvironmentServiceNumber 1 param → 200401403404
GET
/project/{projectId}/environment/overview
List environments overview
getProjectEnvironmentsOverview 1 param → 200401403404

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are EnvironmentStatus (11 properties), EnvironmentOverviewResponse (8 properties), StageStepMetric (4 properties), ClusterOverviewResponse (4 properties). Each schema is shown below with its type and property counts.

ReferenceObject
object
1 property 1 required
ClusterOverviewResponse
object
4 properties 4 required
Environment
EnvironmentResponseList
object
1 property
CloudVendorEnum
string
StageStepMetricNameEnum
string
The name of the deployment step at the stage level: - TOTAL: The total duration of the stage deployment. - QUEUEING: The step preceding the actual stage deploy…
EnvironmentDeploymentStatusEnum
CreateEnvironmentModeEnum
string
EnvironmentStatus
object
11 properties 3 required
ServicesOverviewResponse
object
2 properties 2 required
StageStepMetrics
object
3 properties
StepMetricStatusEnum
string
The status of completion for the step: - SUCCESS: The step completed successfully. - ERROR: The step completed with an error. - CANCEL: The step was canceled.…
EnvironmentStatusEventOriginEnum
string
Origin of the organization event
EnvironmentOverviewResponse
object
8 properties 7 required
StageStepMetric
object
4 properties
EnvironmentModeEnum
string
EnvironmentStatusList
object
1 property
CreateEnvironmentRequest
object
3 properties 1 required
EnvironmentOverviewResponseList
object
1 property
EnvironmentStatsResponseList
object
1 property
ServiceTotalNumber
object
1 property 1 required
StateEnum
string
Base
object
3 properties 2 required
EnvironmentStats

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

qovery-environments-api-openapi.yml Raw ↑

Other APIs Qovery publishes across the network.

Qovery Account Info API
Qovery Alert Receivers API
Qovery Alert Rules API
Qovery Application Actions API
Qovery Application Configuration API
Qovery Application Custom Domain API
Qovery Application Deployment History API
Qovery Application Deployment Restriction API
Qovery Application Environment Variable API
Qovery Application Logs API
Qovery Application Main Calls API
Qovery Application Secret API