Flagsmith

flagsmith Projects API

Manage projects within an organisation. Projects contain environments and feature flags.

GitHub OpenAPI

Operations 46

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 /projects/ List projects I can access across organisations · List projects #
Ask an LLM
“Which Flagsmith projects do I have access to across all my organisations?”
“Is there an unversioned endpoint that lists every project my account can see?”
Tell an agent
Using the unversioned /projects/ endpoint, list every project I can access.
Show all projects across my organisations from the plain projects listing.
POST /projects/ Create a project with just a name and organisation · Create a project #
Ask an LLM
“What is the minimum I need to create a project that will hold environments and flags?”
“Can I create a project by giving only its name and organisation?”
Tell an agent
Create a basic project named {name} in organisation {organisation} using the unversioned projects endpoint.
Make a simple container project {name} under organisation {organisation}.
GET /projects/{project_id}/ Get a project's details · Get a project #
Ask an LLM
“How do I see a project's name, organisation and environments?”
“What environments belong to a given project?”
Tell an agent
Get the details of project {project_id}.
Show project {project_id} along with its environments.
PUT /projects/{project_id}/ Rename or replace a project's details · Update a project #
Ask an LLM
“How do I rename an existing project?”
“Can I move a project's details over with a full replacement update?”
Tell an agent
Rename project {project_id} to {name} in organisation {organisation}.
Replace project {project_id}'s details with name {name} and organisation {organisation}.
DELETE /projects/{project_id}/ Permanently delete a project and everything in it · Delete a project #
Ask an LLM
“What gets wiped when I permanently delete a project and all its environments and flags?”
“Can a deleted project ever be recovered?”
Tell an agent destructive · confirm first
Permanently delete project {project_id} with all its environments and flags via the unversioned endpoint.
Irreversibly remove project {project_id} and its data.
GET /api/v1/projects/ List projects via the v1 API · Api v1 projects list #
Ask an LLM
“How do I list projects through the versioned v1 projects API?”
“Can the v1 API give me my projects along with their settings?”
Tell an agent
List my projects from the v1 projects API.
Fetch the v1 project list with each project's configuration.
POST /api/v1/projects/ Create a project with its settings · Api v1 projects create #
Ask an LLM
“Can I create a project that enforces lower-case feature names or a naming regex?”
“How do I create a project that requires a minimum number of change request approvals?”
Tell an agent
Create project {name} in organisation {organisation} through the v1 API.
Create v1 project {name} in organisation {organisation} with feature name regex {feature_name_regex}.
PATCH /api/v1/projects/{id}/ Change a project's settings · Api v1 projects partial update #
Ask an LLM
“How do I change the stale flag threshold on a project?”
“Can I turn on feature owner enforcement for an existing project?”
Tell an agent
Set project {id}'s stale flag limit to {stale_flags_limit_days} days.
Turn feature owner enforcement to {enforce_feature_owners} on project {id}.
DELETE /api/v1/projects/{id}/ Delete a project via the v1 API · Api v1 projects destroy #
Ask an LLM
“How do I delete a project through the versioned v1 API?”
“Is there a v1 endpoint to remove a project by its ID?”
Tell an agent destructive · confirm first
Delete project {id} using the v1 projects API.
Remove v1 project {id}.
POST /api/v1/projects/{id}/migrate-to-edge/ Migrate a project to Edge · Api v1 projects migrate to edge create #
Ask an LLM
“How do I move a project's identities over to Edge?”
“Can I kick off an Edge migration for one project?”
Tell an agent
Start the Edge migration for project {id}.
Migrate project {id} to Edge.
GET /api/v1/projects/{id}/my-permissions/ Check my permissions on a project · Api v1 projects my permissions retrieve #
Ask an LLM
“What am I allowed to do in this project?”
“Am I an admin on a given project?”
Tell an agent
Show my own permissions on project {id}.
Check whether I have admin rights in project {id}.
GET /api/v1/projects/{id}/user-detailed-permissions/{user_id}/ Get a user's detailed permissions on a project · Api v1 projects user detailed permissions retrieve #
Ask an LLM
“How do I see a detailed breakdown of another user's permissions on a project?”
“Where do a teammate's project permissions come from, direct grants or groups and roles?”
Tell an agent
Show the detailed permissions of user {user_id} on project {id}.
Break down how user {user_id} gets access to project {id}.
GET /api/v1/projects/{project_pk}/all-user-permissions/{user_pk}/ Get all of a user's permissions in a project · Api v1 projects all user permissions retrieve #
Ask an LLM
“Can I get the combined list of every permission a user holds in a project?”
“Which permission keys does a user end up with across a project?”
Tell an agent
List all permissions user {user_pk} holds in project {project_pk}.
Give me the full permission set of user {user_pk} for project {project_pk}.
POST /api/v1/projects/{project_pk}/change-requests/ Open a project-level change request for segments · Api v1 projects change requests create #
Ask an LLM
“How do I propose segment changes for review in a project?”
“Can I assign approval groups when raising a project change request?”
Tell an agent
Open change request {title} in project {project_pk} covering segments {segments}.
Raise a project change request {title} in {project_pk} for segments {segments} described as {description}.
GET /api/v1/projects/{project_pk}/change-requests/{id}/ Get a project change request · Api v1 projects change requests retrieve #
Ask an LLM
“What segment changes and approvals are on a project change request?”
“Has a given project change request been committed yet?”
Tell an agent
Show project change request {id} in project {project_pk}.
Check the approvals on change request {id} for project {project_pk}.
PUT /api/v1/projects/{project_pk}/change-requests/{id}/ Replace a project change request · Api v1 projects change requests update #
Ask an LLM
“How do I fully rewrite a project change request's title and segments?”
“Can I replace everything on an open project change request?”
Tell an agent
Replace project change request {id} in {project_pk} with title {title} and segments {segments}.
Overwrite change request {id} in project {project_pk}: title {title}, segments {segments}.
PATCH /api/v1/projects/{project_pk}/change-requests/{id}/ Edit part of a project change request · Api v1 projects change requests partial update #
Ask an LLM
“Can I just change the description on a project change request?”
“How do I tweak one field of an open project change request?”
Tell an agent
Change the description of project change request {id} in {project_pk} to {description}.
Retitle change request {id} in project {project_pk} as {title}.
DELETE /api/v1/projects/{project_pk}/change-requests/{id}/ Delete a project change request · Api v1 projects change requests destroy #
Ask an LLM
“How do I delete a project change request I no longer need?”
“Can I withdraw a pending segment change request from a project?”
Tell an agent destructive · confirm first
Delete change request {id} from project {project_pk}.
Withdraw project change request {id} in {project_pk}.
POST /api/v1/projects/{project_pk}/change-requests/{id}/approve/ Approve a project change request · Api v1 projects change requests approve create #
Ask an LLM
“How do I approve a colleague's project change request?”
“Can I sign off on a segment change request?”
Tell an agent
Approve change request {id} in project {project_pk}.
Add my approval to project change request {id} in {project_pk}.
POST /api/v1/projects/{project_pk}/change-requests/{id}/commit/ Commit a project change request · Api v1 projects change requests commit create #
Ask an LLM
“How do I apply an approved project change request?”
“What happens when a project change request is committed?”
Tell an agent
Commit project change request {id} in {project_pk}.
Apply the approved change request {id} for project {project_pk}.
POST /api/v1/projects/{project_pk}/code-references/ Record code references to flags for a project · Api v1 projects code references create #
Ask an LLM
“How do I report where feature flags are used in my repository's code?”
“Can I upload code references for a specific repository revision?”
Tell an agent
Record code references {code_references} for repository {repository_url} at revision {revision} in project {project_pk}.
Upload flag usages from {repository_url} revision {revision} into project {project_pk}: {code_references}.
GET /api/v1/projects/{project_pk}/feature-exports/ List a project's feature exports · Api v1 projects feature exports list #
Ask an LLM
“What feature exports have been made from a project?”
“Can I see past exports of a project's features?”
Tell an agent
List the feature exports for project {project_pk}.
Show feature export history for project {project_pk}.
GET /api/v1/projects/{project_pk}/feature-imports/ List a project's feature imports · Api v1 projects feature imports list #
Ask an LLM
“What feature imports have been run into a project?”
“Did my last feature import into a project finish?”
Tell an agent
List the feature imports for project {project_pk}.
Show feature import history for project {project_pk}.
GET /api/v1/projects/{project_pk}/gitlab/issues/ List GitLab issues linked to a project · Api v1 projects gitlab issues list #
Ask an LLM
“Which GitLab issues can I link to flags in a project?”
“Can I browse GitLab issues from the project's GitLab integration?”
Tell an agent
List GitLab issues available to project {project_pk}.
Show the GitLab issues for project {project_pk}.
GET /api/v1/projects/{project_pk}/gitlab/merge-requests/ List GitLab merge requests for a project · Api v1 projects gitlab merge requests list #
Ask an LLM
“Which GitLab merge requests can be linked to flags in my project?”
“Can I browse merge requests through the GitLab integration?”
Tell an agent
List GitLab merge requests for project {project_pk}.
Show the merge requests available to project {project_pk}.
GET /api/v1/projects/{project_pk}/gitlab/projects/ List GitLab projects for the integration · Api v1 projects gitlab projects list #
Ask an LLM
“Which GitLab projects can the integration see for my Flagsmith project?”
“What GitLab repositories are reachable from the GitLab integration?”
Tell an agent
List GitLab projects reachable from project {project_pk}.
Show the GitLab repositories the integration exposes for project {project_pk}.
GET /api/v1/projects/{project_pk}/imports/launch-darkly/ List LaunchDarkly import jobs for a project · Api v1 projects imports launch darkly list #
Ask an LLM
“What LaunchDarkly imports have been run into a project?”
“Can I see all my LaunchDarkly migration attempts for a project?”
Tell an agent
List LaunchDarkly import jobs for project {project_pk}.
Show every LaunchDarkly import run into project {project_pk}.
POST /api/v1/projects/{project_pk}/imports/launch-darkly/ Import flags from LaunchDarkly into a project · Api v1 projects imports launch darkly create #
Ask an LLM
“How do I bring my LaunchDarkly flags into a project?”
“What do I need from LaunchDarkly to start an import?”
Tell an agent
Import LaunchDarkly project {project_key} into project {project_pk} using token {token}.
Start a LaunchDarkly import of {project_key} into {project_pk} with API token {token}.
GET /api/v1/projects/{project_pk}/imports/launch-darkly/{id}/ Check a LaunchDarkly import job · Api v1 projects imports launch darkly retrieve #
Ask an LLM
“What is the status of one LaunchDarkly import?”
“Did a specific LaunchDarkly import complete successfully?”
Tell an agent
Get LaunchDarkly import {id} for project {project_pk}.
Check the progress of LaunchDarkly import job {id} in project {project_pk}.
POST /api/v1/projects/{project_pk}/release-pipelines/ Create a release pipeline · Api v1 projects release pipelines create #
Ask an LLM
“How do I set up a release pipeline that moves features through stages?”
“Can I define the stages when creating a release pipeline?”
Tell an agent
Create release pipeline {name} in project {project_pk} with stages {stages}.
Set up a new release pipeline {name} for project {project_pk} with stages {stages} and description {description}.
PUT /api/v1/projects/{project_pk}/release-pipelines/{id}/ Replace a release pipeline's definition · Api v1 projects release pipelines update #
Ask an LLM
“How do I redefine all the stages of an existing release pipeline?”
“Can I fully replace a release pipeline's name and stages?”
Tell an agent
Replace release pipeline {id} in project {project_pk} with name {name} and stages {stages}.
Overwrite pipeline {id} in {project_pk}: name {name}, stages {stages}.
PATCH /api/v1/projects/{project_pk}/release-pipelines/{id}/ Rename or redescribe a release pipeline · Api v1 projects release pipelines partial update #
Ask an LLM
“Can I just rename a release pipeline without touching its stages?”
“How do I change a release pipeline's description?”
Tell an agent
Rename release pipeline {id} in project {project_pk} to {name}.
Update the description of pipeline {id} in {project_pk} to {description}.
DELETE /api/v1/projects/{project_pk}/release-pipelines/{id}/ Delete a release pipeline · Api v1 projects release pipelines destroy #
Ask an LLM
“How do I delete a release pipeline I no longer use?”
“Can a release pipeline be removed from a project?”
Tell an agent destructive · confirm first
Delete release pipeline {id} from project {project_pk}.
Remove pipeline {id} in project {project_pk}.
POST /api/v1/projects/{project_pk}/release-pipelines/{id}/clone/ Clone a release pipeline · Api v1 projects release pipelines clone create #
Ask an LLM
“Can I copy an existing release pipeline as a starting point for a new one?”
“How do I duplicate a release pipeline under a new name?”
Tell an agent
Clone release pipeline {id} in project {project_pk} as {name} with stages {stages}.
Duplicate pipeline {id} in {project_pk} into a copy called {name} with stages {stages}.
POST /api/v1/projects/{project_pk}/release-pipelines/{id}/publish-pipeline/ Publish a release pipeline · Api v1 projects release pipelines publish pipeline create #
Ask an LLM
“How do I make a draft release pipeline live so features can move through it?”
“What does publishing a release pipeline do?”
Tell an agent
Publish release pipeline {id} named {name} in project {project_pk}.
Make pipeline {id} ({name}) live in project {project_pk}.
POST /api/v1/projects/{project_pk}/release-pipelines/{id}/remove-feature/ Remove a feature from a release pipeline · Api v1 projects release pipelines remove feature create #
Ask an LLM
“How do I pull a feature out of a release pipeline?”
“Can I stop a feature from progressing through a pipeline?”
Tell an agent
Remove features {features} from release pipeline {id} ({name}) in project {project_pk}.
Take a feature out of pipeline {id} named {name} in {project_pk}.
POST /api/v1/projects/{project_pk}/release-pipelines/{id}/unpublish-pipeline/ Unpublish a release pipeline · Api v1 projects release pipelines unpublish pipeline create #
Ask an LLM
“How do I take a published release pipeline back to draft?”
“Can I unpublish a pipeline so I can edit it again?”
Tell an agent
Unpublish release pipeline {id} named {name} in project {project_pk}.
Return pipeline {id} ({name}) in {project_pk} to draft.
GET /api/v1/projects/{project_pk}/tags/ List a project's tags · Api v1 projects tags list #
Ask an LLM
“What tags are defined for labelling features in my project?”
“Which tags can I apply to flags in a project?”
Tell an agent
List the tags in project {project_pk}.
Show all feature tags defined for project {project_pk}.
POST /api/v1/projects/{project_pk}/tags/ Create a tag in a project · Api v1 projects tags create #
Ask an LLM
“How do I add a new coloured tag for labelling features?”
“Can I create a permanent tag that protects flags from deletion?”
Tell an agent
Create tag {label} in project {project_pk}.
Add a tag {label} with colour {color} to project {project_pk}.
GET /api/v1/projects/{project_pk}/tags/{id}/ Get a project tag by ID · Api v1 projects tags retrieve #
Ask an LLM
“How do I look up one tag's label and colour by its ID?”
“Is a specific tag marked as permanent?”
Tell an agent
Get tag {id} in project {project_pk}.
Show the label and colour of tag {id} in project {project_pk}.
PUT /api/v1/projects/{project_pk}/tags/{id}/ Replace a project tag · Api v1 projects tags update #
Ask an LLM
“How do I fully redefine an existing tag?”
“Can I replace a tag's label, colour and description in one go?”
Tell an agent
Replace tag {id} in project {project_pk} with label {label}, colour {color} and description {description}.
Overwrite tag {id} in {project_pk} so its label is {label}.
PATCH /api/v1/projects/{project_pk}/tags/{id}/ Recolour or relabel a project tag · Api v1 projects tags partial update #
Ask an LLM
“Can I just change a tag's colour?”
“How do I mark an existing tag as permanent?”
Tell an agent
Change tag {id} in project {project_pk} to colour {color}.
Set is-permanent to {is_permanent} on tag {id} in {project_pk}.
DELETE /api/v1/projects/{project_pk}/tags/{id}/ Delete a project tag · Api v1 projects tags destroy #
Ask an LLM
“How do I delete a tag I no longer use?”
“Can I remove a tag from a project entirely?”
Tell an agent destructive · confirm first
Delete tag {id} from project {project_pk}.
Remove project tag {id} in {project_pk}.
GET /api/v1/projects/{project_pk}/tags/get-by-uuid/{uuid}/ Get a project tag by UUID · Api v1 projects tags get by uuid retrieve #
Ask an LLM
“Can I look up a tag by its UUID instead of its numeric ID?”
“Which tag does this UUID point to in my project?”
Tell an agent
Get the tag with UUID {uuid} in project {project_pk}.
Resolve tag UUID {uuid} in {project_pk}.
GET /api/v1/projects/get-by-uuid/{uuid}/ Get a project by UUID · Api v1 projects get by uuid retrieve #
Ask an LLM
“Can I find a project using its UUID instead of its numeric ID?”
“Which project does this UUID belong to?”
Tell an agent
Get the project with UUID {uuid}.
Resolve project UUID {uuid} to its details.
GET /api/v1/projects/permissions/ List available project permission types · Api v1 projects permissions list #
Ask an LLM
“What permission types can be granted on a project?”
“Which project-level permission keys exist?”
Tell an agent
List every permission type that can be assigned on a project.
Show the catalogue of project permission keys.

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://raw.githubusercontent.com/api-evangelist/flagsmith/refs/heads/main/openapi/flagsmith-projects-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/flagsmith/refs/heads/main/asyncapi/flagsmith-webhooks-asyncapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/flagsmith/refs/heads/main/overlays/flagsmith-projects-api-overlay.yaml
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/flagsmith/refs/heads/main/collections/flagsmith-projects-api.postman_collection.json
🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/flagsmith/refs/heads/main/collections/flagsmith-projects-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-projects-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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-projects-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Flagsmith Projects API
  version: '1.0'
  description: 'Operations tagged Projects 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 (85 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/flagsmith/refs/heads/main/openapi/flagsmith-projects-api-openapi.yml