Flagsmith

flagsmith Environments API

Manage environments within a project. Environments represent deployment stages such as development, staging, and production.

GitHub OpenAPI

Operations 61

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /environments/ List environments I can access · List environments #
Ask an LLM
“Which Flagsmith environments do I have access to?”
“Can I see all my deployment stages like dev, staging and production in one list?”
Tell an agent
List every environment I have access to.
Show my environments across projects.
GET /environments/{environment_api_key}/ Get an environment (unversioned path) · Get an environment #
Ask an LLM
“What project and feature states belong to an environment, from the unversioned endpoint?”
“Is there a non-v1 route to fetch an environment by its API key?”
Tell an agent
Via the unversioned route, get environment {environment_api_key}.
Show the name, project and feature states of {environment_api_key} from the non-v1 endpoint.
PUT /environments/{environment_api_key}/ Update an environment (unversioned path) · Update an environment #
Ask an LLM
“Can I rename an environment through the unversioned update endpoint?”
“How do I hide sensitive data on an environment using the non-v1 route?”
Tell an agent
On the unversioned route, rename environment {environment_api_key} to {name}.
Update {environment_api_key} as {name} with hide sensitive data {hide_sensitive_data}, non-v1 path.
POST /api/v1/environments/ Create an environment in a project · Api v1 environments create #
Ask an LLM
“How do I add a new staging environment to my project?”
“Can I require change request approvals when creating an environment?”
Tell an agent
Create environment {name} in project {project}.
Add environment {name} to project {project} needing {minimum_change_request_approvals} approvals per change.
GET /api/v1/environments/{api_key}/ Get an environment's settings (v1) · Api v1 environments retrieve #
Ask an LLM
“What settings like banner text or versioning does an environment have in the v1 API?”
“Can I look up one environment by API key with v1?”
Tell an agent
Get v1 environment {api_key}.
Show the configuration of environment {api_key} with the v1 API.
PUT /api/v1/environments/{api_key}/ Replace an environment's settings (v1) · Api v1 environments update #
Ask an LLM
“How do I fully replace an environment's configuration with the v1 API?”
“Does a full v1 environment update require the name?”
Tell an agent
Replace v1 environment {api_key} settings with name {name}.
Overwrite environment {api_key} as {name} with banner text {banner_text}.
PATCH /api/v1/environments/{api_key}/ Change individual environment settings · Api v1 environments partial update #
Ask an LLM
“Can I just set a banner colour on an environment without touching other settings?”
“How do I hide disabled flags from SDKs in one environment?”
Tell an agent
Set the banner on environment {api_key} to {banner_text} in {banner_colour}.
Turn hide disabled flags to {hide_disabled_flags} on environment {api_key}.
DELETE /api/v1/environments/{api_key}/ Delete an environment · Api v1 environments destroy #
Ask an LLM
“How do I remove an environment I no longer use?”
“Can I delete a whole environment by its API key?”
Tell an agent destructive · confirm first
Delete environment {api_key}.
Permanently remove the environment with key {api_key}.
POST /api/v1/environments/{api_key}/clone/ Clone an environment · Api v1 environments clone create #
Ask an LLM
“How do I copy an existing environment with its flags into a new one?”
“Can feature states be cloned asynchronously for a large environment?”
Tell an agent
Clone environment {api_key} into a new one called {name}.
Copy {api_key} as {name}, cloning feature states async {clone_feature_states_async}.
POST /api/v1/environments/{api_key}/delete-traits/ Delete a trait from all identities · Api v1 environments delete traits create #
Ask an LLM
“How do I wipe a trait key from every identity in an environment?”
“Can I remove an obsolete trait across the whole environment at once?”
Tell an agent destructive · confirm first
Delete trait {key} from all identities in environment {api_key}.
Remove the {key} trait everywhere in environment {api_key}.
POST /api/v1/environments/{api_key}/disable-v2-versioning/ Turn off v2 feature versioning · Api v1 environments disable v2 versioning create #
Ask an LLM
“How do I switch an environment back off v2 feature versioning?”
“Can v2 versioning be disabled after enabling it?”
Tell an agent
Disable v2 feature versioning on environment {api_key}.
Turn off feature versioning v2 for {api_key}.
GET /api/v1/environments/{api_key}/document/ Get the environment document · Api v1 environments document retrieve #
Ask an LLM
“How do I download the full environment document used for local evaluation?”
“Is there a single JSON document describing an environment's flags and segments?”
Tell an agent
Get the environment document for {api_key}.
Download the local evaluation document of environment {api_key}.
POST /api/v1/environments/{api_key}/enable-v2-versioning/ Turn on v2 feature versioning · Api v1 environments enable v2 versioning create #
Ask an LLM
“How do I enable v2 feature versioning on an environment?”
“Can I start versioning flag changes in one environment?”
Tell an agent
Enable v2 feature versioning on environment {api_key}.
Switch environment {api_key} to feature versioning v2.
GET /api/v1/environments/{api_key}/my-permissions/ Check my permissions on an environment · Api v1 environments my permissions retrieve #
Ask an LLM
“What am I allowed to do in this environment?”
“Am I an admin of a given environment?”
Tell an agent
Show my permissions on environment {api_key}.
Check what I can do in {api_key}.
GET /api/v1/environments/{api_key}/trait-keys/ List trait keys used in an environment · Api v1 environments trait keys retrieve #
Ask an LLM
“Which trait keys exist on identities in my environment?”
“Can I see all the trait names in use before building a segment?”
Tell an agent
List trait keys in environment {api_key}.
Show every distinct trait name used in {api_key}.
GET /api/v1/environments/{api_key}/user-detailed-permissions/{user_id}/ Get a user's detailed environment permissions · Api v1 environments user detailed permissions retrieve #
Ask an LLM
“What permissions does a particular teammate have in an environment, and where do they come from?”
“Can I see whether a user's environment access comes from a group or role?”
Tell an agent
Show detailed permissions for user {user_id} in environment {api_key}.
Explain what user {user_id} can do in {api_key} and why.
GET /api/v1/environments/{environment_api_key}/api-keys/ List server-side SDK keys · Api v1 environments api keys list #
Ask an LLM
“Which server-side SDK keys exist for my environment?”
“Can I see which server keys are active or expiring?”
Tell an agent
List server-side SDK keys for environment {environment_api_key}.
Show the active server keys on {environment_api_key}.
POST /api/v1/environments/{environment_api_key}/api-keys/ Create a server-side SDK key · Api v1 environments api keys create #
Ask an LLM
“How do I generate a server-side SDK key for my backend?”
“Can I set an expiry date on a new server key?”
Tell an agent
Create a server-side key named {name} for environment {environment_api_key}.
Generate server key {name} on {environment_api_key} that expires at {expires_at}.
PUT /api/v1/environments/{environment_api_key}/api-keys/{id}/ Replace a server-side SDK key's settings · Api v1 environments api keys update #
Ask an LLM
“How do I fully update a server key's name and expiry?”
“Does replacing a server-side key's settings require its name?”
Tell an agent
Replace server key {id} on {environment_api_key} with name {name}.
Overwrite server-side key {id} in {environment_api_key} as {name}, expiring {expires_at}.
PATCH /api/v1/environments/{environment_api_key}/api-keys/{id}/ Deactivate or rename a server-side SDK key · Api v1 environments api keys partial update #
Ask an LLM
“Can I deactivate a server key without deleting it?”
“Is it possible to change only a server key's expiry date?”
Tell an agent
Set active to {active} on server key {id} in {environment_api_key}.
Move the expiry of server-side key {id} on {environment_api_key} to {expires_at}.
DELETE /api/v1/environments/{environment_api_key}/api-keys/{id}/ Delete a server-side SDK key · Api v1 environments api keys destroy #
Ask an LLM
“How do I revoke a leaked server-side SDK key?”
“Can I delete an old server key from an environment?”
Tell an agent destructive · confirm first
Delete server-side key {id} from environment {environment_api_key}.
Revoke server key {id} on {environment_api_key} now.
GET /api/v1/environments/{environment_api_key}/cohorts/ List an environment's cohorts · Api v1 environments cohorts list #
Ask an LLM
“What cohorts are defined in my environment?”
“Can I see the membership counts of each cohort?”
Tell an agent
List cohorts in environment {environment_api_key}.
Show all cohorts on {environment_api_key} with their sizes.
POST /api/v1/environments/{environment_api_key}/cohorts/ Create a cohort and its managed segment · Api v1 environments cohorts create #
Ask an LLM
“How do I create a cohort that flags can target as a segment?”
“Does creating a cohort also create a segment for it?”
Tell an agent
Create cohort {name} in environment {environment_api_key}.
Add a cohort called {name} to {environment_api_key} described as {description}.
GET /api/v1/environments/{environment_api_key}/cohorts/{cohort_id}/ Get a cohort · Api v1 environments cohorts retrieve #
Ask an LLM
“When was a cohort last synced and how many members does it have?”
“Can I look up one cohort by ID?”
Tell an agent
Get cohort {cohort_id} in environment {environment_api_key}.
Show last sync time and membership of cohort {cohort_id} on {environment_api_key}.
PATCH /api/v1/environments/{environment_api_key}/cohorts/{cohort_id}/ Rename or describe a cohort · Api v1 environments cohorts partial update #
Ask an LLM
“Can I rename a cohort's managed segment?”
“How do I update a cohort's description or metadata?”
Tell an agent
Rename cohort {cohort_id} in {environment_api_key} to {name}.
Set the description of cohort {cohort_id} on {environment_api_key} to {description}.
DELETE /api/v1/environments/{environment_api_key}/cohorts/{cohort_id}/ Delete a cohort · Api v1 environments cohorts destroy #
Ask an LLM
“What happens to identity data when I delete a cohort?”
“How do I remove a cohort and its segment?”
Tell an agent destructive · confirm first
Delete cohort {cohort_id} from environment {environment_api_key}.
Request removal of cohort {cohort_id} and its segment on {environment_api_key}.
POST /api/v1/environments/{environment_api_key}/cohorts/{cohort_id}/sync-csv/ Replace cohort members from a CSV · Api v1 environments cohorts sync csv create #
Ask an LLM
“How do I upload a CSV of user identifiers to set a cohort's members?”
“Can I tell it which CSV column holds the identifiers and skip a header row?”
Tell an agent
Replace cohort {cohort_id} members in {environment_api_key} with the identifiers in {file}.
Sync {file} into cohort {cohort_id} on {environment_api_key} using column {identifier_column}, header {has_header}.
GET /api/v1/environments/{environment_api_key}/cohorts/sync-keys/ List cohort sync keys · Api v1 environments cohorts sync keys list #
Ask an LLM
“Which cohort sync keys exist for my environment?”
“Can I see the prefixes of cohort sync keys I've issued?”
Tell an agent
List cohort sync keys for environment {environment_api_key}.
Show the sync key prefixes on {environment_api_key}.
POST /api/v1/environments/{environment_api_key}/cohorts/sync-keys/ Create a cohort sync key · Api v1 environments cohorts sync keys create #
Ask an LLM
“How do I get a key an external tool can use to sync cohorts?”
“When can I see the plaintext of a new cohort sync key?”
Tell an agent
Create a cohort sync key named {name} for {environment_api_key}.
Issue sync key {name} on environment {environment_api_key} and show me the plaintext once.
DELETE /api/v1/environments/{environment_api_key}/cohorts/sync-keys/{prefix}/ Revoke a cohort sync key · Api v1 environments cohorts sync keys destroy #
Ask an LLM
“How do I revoke a cohort sync key that's no longer used?”
“Can I cut off a sync integration by removing its key?”
Tell an agent destructive · confirm first
Revoke cohort sync key {prefix} on environment {environment_api_key}.
Delete the sync key with prefix {prefix} from {environment_api_key}.
GET /api/v1/environments/{environment_api_key}/edge-identity-overrides List Edge identity overrides · Api v1 environments edge identity overrides retrieve #
Ask an LLM
“Which identities have their own override for a flag on Edge?”
“Can I filter Edge identity overrides to a single feature?”
Tell an agent
List Edge identity overrides in environment {environment_api_key}.
Show identity overrides for feature {feature} on {environment_api_key}.
PATCH /api/v1/environments/{environment_api_key}/experiment-metrics/{id}/ Edit an environment experiment metric · Api v1 environments experiment metrics partial update #
Ask an LLM
“Can I change how an experiment metric aggregates, like sum versus count?”
“How do I flip a metric definition's desired direction?”
Tell an agent
Set aggregation of experiment metric {id} on {environment_api_key} to {aggregation}.
Change metric definition {id} in {environment_api_key} to direction {direction}.
DELETE /api/v1/environments/{environment_api_key}/experiment-metrics/{id}/ Delete an environment experiment metric · Api v1 environments experiment metrics destroy #
Ask an LLM
“How do I remove a metric definition from an environment's metric library?”
“Can I delete an experiment metric I no longer track?”
Tell an agent destructive · confirm first
Delete experiment metric {id} from environment {environment_api_key}.
Remove the metric definition {id} on {environment_api_key}.
GET /api/v1/environments/{environment_api_key}/experiments/{experiment_experiment_id}/metrics/ List an experiment's metrics · Api v1 environments experiments metrics list #
Ask an LLM
“What metrics is a given experiment measuring?”
“Can I see the expected direction for each metric on an experiment?”
Tell an agent
List metrics on experiment {experiment_experiment_id} in {environment_api_key}.
Show what experiment {experiment_experiment_id} on {environment_api_key} is tracking.
POST /api/v1/environments/{environment_api_key}/experiments/{experiment_experiment_id}/metrics/ Attach a metric to an experiment · Api v1 environments experiments metrics create #
Ask an LLM
“How do I add a conversion metric to an experiment?”
“Do I have to say whether a metric should go up or down when attaching it?”
Tell an agent
Attach metric {metric} to experiment {experiment_experiment_id} in {environment_api_key}, expecting {expected_direction}.
Track metric {metric} on experiment {experiment_experiment_id}, {environment_api_key}, and expect it to move {expected_direction}.
GET /api/v1/environments/{environment_api_key}/experiments/{experiment_experiment_id}/metrics/{id}/ Get one metric on an experiment · Api v1 environments experiments metrics retrieve #
Ask an LLM
“What's the expected direction for a specific metric on my experiment?”
“Can I fetch one experiment metric link by ID?”
Tell an agent
Get metric {id} of experiment {experiment_experiment_id} in {environment_api_key}.
Show experiment {experiment_experiment_id}'s metric {id} on {environment_api_key}.
PUT /api/v1/environments/{environment_api_key}/experiments/{experiment_experiment_id}/metrics/{id}/ Replace a metric on an experiment · Api v1 environments experiments metrics update #
Ask an LLM
“How do I swap an experiment's metric for a different one?”
“Does replacing an experiment metric require the expected direction again?”
Tell an agent
Replace metric {id} on experiment {experiment_experiment_id}, {environment_api_key}, with {metric} expecting {expected_direction}.
Overwrite experiment {experiment_experiment_id} metric link {id} in {environment_api_key} to use {metric}, direction {expected_direction}.
PATCH /api/v1/environments/{environment_api_key}/experiments/{experiment_experiment_id}/metrics/{id}/ Change an experiment metric's direction · Api v1 environments experiments metrics partial update #
Ask an LLM
“Can I change only the expected direction of a metric on an experiment?”
“Is there a way to edit one field of an experiment's metric link?”
Tell an agent
Set expected direction of metric {id} on experiment {experiment_experiment_id}, {environment_api_key}, to {expected_direction}.
Patch experiment {experiment_experiment_id} metric {id} in {environment_api_key} to aggregate by {aggregation}.
DELETE /api/v1/environments/{environment_api_key}/experiments/{experiment_experiment_id}/metrics/{id}/ Detach a metric from an experiment · Api v1 environments experiments metrics destroy #
Ask an LLM
“How do I stop an experiment measuring a particular metric?”
“Can I detach a metric from one experiment without deleting its definition?”
Tell an agent destructive · confirm first
Detach metric {id} from experiment {experiment_experiment_id} in {environment_api_key}.
Remove metric {id} from experiment {experiment_experiment_id} only, on {environment_api_key}.
PATCH /api/v1/environments/{environment_api_key}/experiments/{experiment_id}/ Edit an experiment's name or hypothesis · Api v1 environments experiments partial update #
Ask an LLM
“Can I update the hypothesis of an experiment?”
“How do I rename an experiment?”
Tell an agent
Set the hypothesis of experiment {experiment_id} in {environment_api_key} to {hypothesis}.
Rename experiment {experiment_id} on {environment_api_key} to {name}.
DELETE /api/v1/environments/{environment_api_key}/experiments/{experiment_id}/ Delete an experiment · Api v1 environments experiments destroy #
Ask an LLM
“How do I delete an experiment I set up by mistake?”
“Can I remove an experiment from an environment entirely?”
Tell an agent destructive · confirm first
Delete experiment {experiment_id} from environment {environment_api_key}.
Remove experiment {experiment_id} on {environment_api_key} permanently.
POST /api/v1/environments/{environment_api_key}/experiments/{experiment_id}/complete/ Complete an experiment · Api v1 environments experiments complete create #
Ask an LLM
“How do I mark an experiment as finished?”
“Can I end an experiment once I have a result?”
Tell an agent
Complete experiment {experiment_id} in {environment_api_key}.
End experiment {experiment_id} named {name} with hypothesis {hypothesis} on {environment_api_key}.
POST /api/v1/environments/{environment_api_key}/experiments/{experiment_id}/exposures/refresh/ Refresh an experiment's exposure data · Api v1 environments experiments exposures refresh create #
Ask an LLM
“How do I recompute how many users were exposed to each variant?”
“Can I force an update of experiment exposure counts?”
Tell an agent
Refresh exposures for experiment {experiment_id} in {environment_api_key}.
Recompute variant exposures of experiment {experiment_id} on feature {feature}, {environment_api_key}.
POST /api/v1/environments/{environment_api_key}/experiments/{experiment_id}/pause/ Pause an experiment · Api v1 environments experiments pause create #
Ask an LLM
“How do I temporarily stop an experiment from running?”
“Can I pause an experiment and resume later?”
Tell an agent
Pause experiment {experiment_id} in {environment_api_key}.
Put experiment {experiment_id} on hold in environment {environment_api_key}.
POST /api/v1/environments/{environment_api_key}/experiments/{experiment_id}/results/refresh/ Refresh an experiment's results · Api v1 environments experiments results refresh create #
Ask an LLM
“How do I recalculate an experiment's results with the latest data?”
“Can I trigger a fresh results computation for one experiment?”
Tell an agent
Refresh results for experiment {experiment_id} in {environment_api_key}.
Recalculate outcomes of experiment {experiment_id} on feature {feature}, {environment_api_key}.
PATCH /api/v1/environments/{environment_api_key}/experiments/{experiment_id}/rollout/ Set an experiment's rollout and audience · Api v1 environments experiments rollout partial update #
Ask an LLM
“What percentage of eligible users should enter my experiment, and how do I set it?”
“Can I change an experiment's target audience after it starts serving traffic?”
Tell an agent
Roll experiment {experiment_id} in {environment_api_key} out to {rollout_percentage} percent of identities.
Target experiment {experiment_id} on {environment_api_key} at audience {audience} with variant weights {multivariate_feature_state_values}.
POST /api/v1/environments/{environment_api_key}/experiments/{experiment_id}/start/ Start an experiment · Api v1 environments experiments start create #
Ask an LLM
“How do I launch an experiment so it begins serving variants?”
“Can I start a paused or draft experiment?”
Tell an agent
Start experiment {experiment_id} in {environment_api_key}.
Launch experiment {experiment_id} named {name} testing {hypothesis} on {environment_api_key}.
GET /api/v1/environments/{environment_api_key}/experiments/results/ Get A/B test results for a feature · Api v1 environments experiments results retrieve #
Ask an LLM
“Which variant of my flag is converting better, and is it statistically significant?”
“What traits do I need to set so variant and conversion tracking works?”
Tell an agent
Show experiment results for feature {feature} in environment {environment_api_key}.
Compare conversion rates per variant of {feature} on {environment_api_key}.
GET /api/v1/environments/{environment_api_key}/metrics/ Get usage metrics for an environment · Api v1 environments metrics list #
Ask an LLM
“What are the headline metrics for my environment?”
“Can I page through an environment's metrics?”
Tell an agent
Get metrics for environment {environment_api_key}.
Show page {page} of {environment_api_key}'s environment metrics.
GET /api/v1/environments/{environment_api_key}/onboarding-status/ Check if an environment's flags were evaluated · Api v1 environments onboarding status retrieve #
Ask an LLM
“Has my app evaluated any flags in this environment yet?”
“How can I tell whether SDK setup is working for a new environment?”
Tell an agent
Check onboarding status for environment {environment_api_key}.
Tell me whether features in {environment_api_key} have been evaluated yet.
GET /api/v1/environments/{environment_api_key}/warehouse-connections/ List data warehouse connections · Api v1 environments warehouse connections list #
Ask an LLM
“Which data warehouses are connected to my environment?”
“Can I see the status of each warehouse connection?”
Tell an agent
List warehouse connections for environment {environment_api_key}.
Show every data warehouse hooked up to {environment_api_key} and its status.
POST /api/v1/environments/{environment_api_key}/warehouse-connections/ Connect a data warehouse · Api v1 environments warehouse connections create #
Ask an LLM
“How do I connect my data warehouse to an environment for experiment data?”
“What do I have to supply when adding a warehouse connection?”
Tell an agent
Connect a {warehouse_type} warehouse to environment {environment_api_key}.
Add warehouse connection {name} of type {warehouse_type} to {environment_api_key} using config {config} and credentials {credentials}.
GET /api/v1/environments/{environment_api_key}/warehouse-connections/{connection_id}/ Get a data warehouse connection · Api v1 environments warehouse connections retrieve #
Ask an LLM
“How many events has a warehouse connection received so far?”
“Can I check one warehouse connection's status detail?”
Tell an agent
Get warehouse connection {connection_id} in {environment_api_key}.
Show event totals and status for connection {connection_id} on {environment_api_key}.
PUT /api/v1/environments/{environment_api_key}/warehouse-connections/{connection_id}/ Replace a data warehouse connection · Api v1 environments warehouse connections update #
Ask an LLM
“How do I fully reconfigure a warehouse connection?”
“Does replacing a warehouse connection require its type again?”
Tell an agent
Replace warehouse connection {connection_id} on {environment_api_key} as type {warehouse_type}.
Overwrite connection {connection_id} in {environment_api_key} with {warehouse_type} config {config}.
PATCH /api/v1/environments/{environment_api_key}/warehouse-connections/{connection_id}/ Edit a data warehouse connection · Api v1 environments warehouse connections partial update #
Ask an LLM
“Can I rotate just the credentials on a warehouse connection?”
“Is there a way to rename a warehouse connection only?”
Tell an agent
Update credentials of warehouse connection {connection_id} on {environment_api_key} to {credentials}.
Rename connection {connection_id} in {environment_api_key} to {name}.
DELETE /api/v1/environments/{environment_api_key}/warehouse-connections/{connection_id}/ Delete a data warehouse connection · Api v1 environments warehouse connections destroy #
Ask an LLM
“How do I disconnect a data warehouse from an environment?”
“Can I delete a warehouse connection I set up wrong?”
Tell an agent destructive · confirm first
Delete warehouse connection {connection_id} from {environment_api_key}.
Disconnect warehouse {connection_id} on environment {environment_api_key}.
GET /api/v1/environments/{environment_api_key}/warehouse-connections/{connection_id}/events/ List event names in a connected warehouse · Api v1 environments warehouse connections events list #
Ask an LLM
“What distinct event names exist in my connected warehouse?”
“Which warehouse events could I use as experiment metrics?”
Tell an agent
List event names in warehouse connection {connection_id} on {environment_api_key}.
Show the distinct events available from connection {connection_id}, {environment_api_key}.
POST /api/v1/environments/{environment_api_key}/warehouse-connections/{connection_id}/test-warehouse-connection/ Test a saved warehouse connection · Api v1 environments warehouse connections test warehouse connection create #
Ask an LLM
“How do I check an existing warehouse connection still works?”
“Can I re-test a saved connection after changing credentials?”
Tell an agent
Test saved warehouse connection {connection_id} on {environment_api_key} as type {warehouse_type}.
Verify existing connection {connection_id} in {environment_api_key} can reach the {warehouse_type} warehouse.
POST /api/v1/environments/{environment_api_key}/warehouse-connections/test-warehouse-connection/ Test warehouse settings before saving · Api v1 environments warehouse connections test warehouse connection config… #
Ask an LLM
“Can I try out warehouse credentials before creating the connection?”
“How do I validate a warehouse config without saving it?”
Tell an agent
Test an unsaved {warehouse_type} warehouse config {config} for {environment_api_key}.
Before saving, check {warehouse_type} credentials {credentials} work for environment {environment_api_key}.
GET /api/v1/environments/get-by-uuid/{uuid}/ Look up an environment by UUID · Api v1 environments get by uuid retrieve #
Ask an LLM
“Can I find an environment when I only have its UUID, not its API key?”
“Which endpoint resolves an environment UUID?”
Tell an agent
Get the environment with UUID {uuid}.
Resolve environment UUID {uuid} to its details.
GET /api/v1/environments/permissions/ List available environment permissions · Api v1 environments permissions list #
Ask an LLM
“What permission types can be granted on an environment?”
“Which environment-level permissions exist for roles and groups?”
Tell an agent
List the permissions that can be assigned on environments.
Show page {page} of available environment permissions.

Documentation

📖
Documentation
https://docs.flagsmith.com/integrating-with-flagsmith/flagsmith-api-overview/admin-api
📖
APIReference
https://docs.flagsmith.com/integrating-with-flagsmith/flagsmith-api-overview/management-api/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/flagsmith/openapi/flagsmith-environments-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/flagsmith/asyncapi/flagsmith-webhooks-asyncapi.yml

Other Resources

🔗
Overlay
https://artifacts.apis.io/flagsmith/overlays/flagsmith-environments-api-overlay.yaml
🔗
PostmanCollection
https://artifacts.apis.io/flagsmith/collections/flagsmith-environments-api.postman_collection.json
🔗
OpenCollection
https://artifacts.apis.io/flagsmith/collections/flagsmith-environments-api.opencollection.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/flagsmith:flagsmith-environments-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

flagsmith-environments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Flagsmith Environments API
  version: '1.0'
  description: 'Operations tagged Environments across 2 of this provider''s published API definitions: flagsmith-admin-api-openapi.yml, flagsmith-api-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.flagsmith.com/api/v1
  description: Flagsmith Production API
tags:


# --- truncated at 32 KB (114 KB total) ---
# Full source: https://artifacts.apis.io/flagsmith/openapi/flagsmith-environments-api-openapi.yml