GET https://api.ap1.datadoghq.com/api/v2/feature-flags/environments https://api.ap2.datadoghq.com/api/v2/feature-flags/environments https://api.datadoghq.eu/api/v2/feature-flags/environments https://api.ddog-gov.com/api/v2/feature-flags/environments https://api.us2.ddog-gov.com/api/v2/feature-flags/environments https://api.datadoghq.com/api/v2/feature-flags/environments https://api.us3.datadoghq.com/api/v2/feature-flags/environments https://api.us5.datadoghq.com/api/v2/feature-flags/environments
Overview Returns a list of environments for the organization.
Supports filtering by name and key.
This endpoint requires the feature_flag_environment_config_read permission.
Arguments Query Strings Filter environments by name (partial matching).
Filter environments by key (partial matching).
Maximum number of results to return.
Number of results to skip.
Response OK
Response containing a list of environments.
Expand All
Attributes of an environment.
The timestamp when the environment was created.
The description of the environment.
Indicates whether this is a production environment.
The unique key of the environment.
The name of the environment.
List of queries to define the environment scope.
require_feature_flag_approval
Indicates whether feature flag changes require approval in this environment.
The timestamp when the environment was last updated.
The unique identifier of the environment.
The resource type.
Allowed enum values: environments
Pagination metadata for environments.
Pagination metadata for environments list responses.
Total number of items matching the filter.
{
"data" : [
{
"attributes" : {
"created_at" : "2023-01-01T00:00:00Z" ,
"description" : "Test environment XYZ789" ,
"is_production" : false ,
"key" : "env-search-term" ,
"name" : "env-search-term" ,
"queries" : [
"staging" ,
"test"
],
"require_feature_flag_approval" : false ,
"updated_at" : "2023-01-01T00:00:00Z"
},
"id" : "550e8400-e29b-41d4-a716-446655440001" ,
"type" : "environments"
}
],
"meta" : {
"page" : {
"total_count" : 10 ,
"total_filtered_count" : 5
}
}
} Forbidden
{
"errors" : [
"Bad Request"
]
} Too many requests
{
"errors" : [
"Bad Request"
]
} Code Example Copy
# Curl command curl -X GET "https://api.ap1.datadoghq.com "https://api.ap2.datadoghq.com "https://api.datadoghq.eu "https://api.ddog-gov.com "https://api.us2.ddog-gov.com "https://api.datadoghq.com "https://api.us3.datadoghq.com "https://api.us5.datadoghq.com /api/v2/feature-flags/environments " \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY} " \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY} "
"""
List environments returns "OK" response
"""
from datadog_api_client import ApiClient , Configuration
from datadog_api_client.v2.api.feature_flags_api import FeatureFlagsApi
configuration = Configuration ()
with ApiClient ( configuration ) as api_client :
api_instance = FeatureFlagsApi ( api_client )
response = api_instance . list_feature_flags_environments ()
print ( response )
Instructions First install the library and its dependencies and then save the example to example.py and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<DD_API_KEY>" DD_APP_KEY = "<DD_APP_KEY>" python3 "example.py"
# List environments returns "OK" response
require "datadog_api_client"
api_instance = DatadogAPIClient :: V2 :: FeatureFlagsAPI . new
p api_instance . list_feature_flags_environments ()
Instructions First install the library and its dependencies and then save the example to example.rb and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<DD_API_KEY>" DD_APP_KEY = "<DD_APP_KEY>" rb "example.rb"
// List environments returns "OK" response
package main
import (
"context"
"encoding/json"
"fmt"
"os"
"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
"github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"
)
func main () {
ctx := datadog . NewDefaultContext ( context . Background ())
configuration := datadog . NewConfiguration ()
apiClient := datadog . NewAPIClient ( configuration )
api := datadogV2 . NewFeatureFlagsApi ( apiClient )
resp , r , err := api . ListFeatureFlagsEnvironments ( ctx , * datadogV2 . NewListFeatureFlagsEnvironmentsOptionalParameters ())
if err != nil {
fmt . Fprintf ( os . Stderr , "Error when calling `FeatureFlagsApi.ListFeatureFlagsEnvironments`: %v\n" , err )
fmt . Fprintf ( os . Stderr , "Full HTTP response: %v\n" , r )
}
responseContent , _ := json . MarshalIndent ( resp , "" , " " )
fmt . Fprintf ( os . Stdout , "Response from `FeatureFlagsApi.ListFeatureFlagsEnvironments`:\n%s\n" , responseContent )
}
Instructions First install the library and its dependencies and then save the example to main.go and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<DD_API_KEY>" DD_APP_KEY = "<DD_APP_KEY>" go run "main.go"
// List environments returns "OK" response
import com.datadog.api.client.ApiClient ;
import com.datadog.api.client.ApiException ;
import com.datadog.api.client.v2.api.FeatureFlagsApi ;
import com.datadog.api.client.v2.model.ListEnvironmentsResponse ;
public class Example {
public static void main ( String [] args ) {
ApiClient defaultClient = ApiClient . getDefaultApiClient ();
FeatureFlagsApi apiInstance = new FeatureFlagsApi ( defaultClient );
try {
ListEnvironmentsResponse result = apiInstance . listFeatureFlagsEnvironments ();
System . out . println ( result );
} catch ( ApiException e ) {
System . err . println ( "Exception when calling FeatureFlagsApi#listFeatureFlagsEnvironments" );
System . err . println ( "Status code: " + e . getCode ());
System . err . println ( "Reason: " + e . getResponseBody ());
System . err . println ( "Response headers: " + e . getResponseHeaders ());
e . printStackTrace ();
}
}
}
Instructions First install the library and its dependencies and then save the example to Example.java and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<DD_API_KEY>" DD_APP_KEY = "<DD_APP_KEY>" java "Example.java"
// List environments returns "OK" response
use datadog_api_client ::datadog ;
use datadog_api_client ::datadogV2 ::api_feature_flags ::FeatureFlagsAPI ;
use datadog_api_client ::datadogV2 ::api_feature_flags ::ListFeatureFlagsEnvironmentsOptionalParams ;
#[tokio::main]
async fn main () {
let configuration = datadog ::Configuration ::new ();
let api = FeatureFlagsAPI ::with_config ( configuration );
let resp = api
. list_feature_flags_environments ( ListFeatureFlagsEnvironmentsOptionalParams ::default ())
. await ;
if let Ok ( value ) = resp {
println! ( " {:#?} " , value );
} else {
println! ( " {:#?} " , resp . unwrap_err ());
}
}
Instructions First install the library and its dependencies and then save the example to src/main.rs and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<DD_API_KEY>" DD_APP_KEY = "<DD_APP_KEY>" cargo run
/**
* List environments returns "OK" response
*/
import { client , v2 } from "@datadog/datadog-api-client" ;
const configuration = client . createConfiguration ();
const apiInstance = new v2 . FeatureFlagsApi ( configuration );
apiInstance
. listFeatureFlagsEnvironments ()
. then (( data : v2.ListEnvironmentsResponse ) => {
console . log (
"API called successfully. Returned data: " + JSON . stringify ( data )
);
})
. catch (( error : any ) => console . error ( error ));
Instructions First install the library and its dependencies and then save the example to example.ts and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<DD_API_KEY>" DD_APP_KEY = "<DD_APP_KEY>" tsc "example.ts"