Flagsmith

Flagsmith Permissions API

Manage user and group permissions across organisations, projects, and environments.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 34

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 /api/v1/environments/{environment_api_key}/user-group-permissions/ List group permissions on an environment · Api v1 environments user group permissions list #
Ask an LLM
“Which user groups have access to this environment?”
“What permissions does each group hold on a single environment?”
Tell an agent
List the group permission grants on environment {environment_api_key}.
Show which teams can act in environment {environment_api_key} and with what rights.
POST /api/v1/environments/{environment_api_key}/user-group-permissions/ Grant a group access to an environment · Api v1 environments user group permissions create #
Ask an LLM
“How do I give a whole team permissions on one environment?”
“Can I make a group an admin of a specific environment?”
Tell an agent
Grant group {group} permissions {permissions} on environment {environment_api_key}.
Make group {group} an environment admin ({admin}) in {environment_api_key}.
GET /api/v1/environments/{environment_api_key}/user-group-permissions/{id}/ Get one group's environment permission grant · Api v1 environments user group permissions retrieve #
Ask an LLM
“What exactly can a given group do in this environment?”
“Is a particular group grant on an environment an admin grant?”
Tell an agent
Show environment group grant {id} in {environment_api_key}.
Tell me whether group permission record {id} on environment {environment_api_key} includes admin.
PUT /api/v1/environments/{environment_api_key}/user-group-permissions/{id}/ Replace a group's environment permissions · Api v1 environments user group permissions update #
Ask an LLM
“Can I overwrite the full set of rights a team has on an environment?”
“What must I resend to replace a group's environment grant?”
Tell an agent
Replace environment group grant {id} in {environment_api_key} so group {group} has exactly {permissions}.
Overwrite the environment {environment_api_key} grant {id} for group {group}, admin set to {admin}.
PATCH /api/v1/environments/{environment_api_key}/user-group-permissions/{id}/ Adjust part of a group's environment grant · Api v1 environments user group permissions partial update #
Ask an LLM
“Can I just toggle admin on a group's environment grant?”
“Is it possible to tweak a team's environment rights without resending the group?”
Tell an agent
Patch environment group grant {id} in {environment_api_key} to set admin {admin}.
Change only the permission list of team grant {id} on environment {environment_api_key} to {permissions}.
DELETE /api/v1/environments/{environment_api_key}/user-group-permissions/{id}/ Revoke a group's environment access · Api v1 environments user group permissions destroy #
Ask an LLM
“How do I take a team's access away from an environment?”
“Can I remove one group's environment grant without touching its project rights?”
Tell an agent destructive · confirm first
Revoke environment group grant {id} in {environment_api_key}.
Remove the team permission record {id} from environment {environment_api_key}.
GET /api/v1/environments/{environment_api_key}/user-permissions/ List user permissions on an environment · Api v1 environments user permissions list #
Ask an LLM
“Which individual users have direct access to this environment?”
“What rights does each person hold on one environment?”
Tell an agent
List the individual user grants on environment {environment_api_key}.
Show which people have direct permissions in environment {environment_api_key}.
POST /api/v1/environments/{environment_api_key}/user-permissions/ Grant a user access to an environment · Api v1 environments user permissions create #
Ask an LLM
“How do I give one person permissions on a single environment?”
“Can I make an individual user an environment admin?”
Tell an agent
Grant user {user} permissions {permissions} on environment {environment_api_key}.
Make person {user} an admin ({admin}) of environment {environment_api_key}.
GET /api/v1/environments/{environment_api_key}/user-permissions/{id}/ Get one user's environment permission grant · Api v1 environments user permissions retrieve #
Ask an LLM
“What can a specific person do in this environment?”
“Does a given user grant on an environment include admin?”
Tell an agent
Show environment user grant {id} in {environment_api_key}.
Tell me the rights in individual permission record {id} for environment {environment_api_key}.
PUT /api/v1/environments/{environment_api_key}/user-permissions/{id}/ Replace a user's environment permissions · Api v1 environments user permissions update #
Ask an LLM
“Can I overwrite everything a person is allowed to do in an environment?”
“What does a full replacement of a user's environment grant need?”
Tell an agent
Replace environment user grant {id} in {environment_api_key} so user {user} has exactly {permissions}.
Overwrite person {user}'s grant {id} on environment {environment_api_key} with admin {admin}.
PATCH /api/v1/environments/{environment_api_key}/user-permissions/{id}/ Adjust part of a user's environment grant · Api v1 environments user permissions partial update #
Ask an LLM
“Can I just flip admin on for a person in an environment?”
“Is a partial change to one user's environment rights possible?”
Tell an agent
Patch environment user grant {id} in {environment_api_key} to admin {admin}.
Change only the permission keys on person grant {id} in environment {environment_api_key} to {permissions}.
DELETE /api/v1/environments/{environment_api_key}/user-permissions/{id}/ Revoke a user's environment access · Api v1 environments user permissions destroy #
Ask an LLM
“How do I remove one person's direct access to an environment?”
“Will revoking a user's environment grant also drop their group-based access?”
Tell an agent destructive · confirm first
Revoke environment user grant {id} in {environment_api_key}.
Delete the individual permission record {id} on environment {environment_api_key}.
GET /api/v1/organisations/{organisation_pk}/user-group-permissions/ List group permissions on an organisation · Api v1 organisations user group permissions list #
Ask an LLM
“Which groups hold organisation-level permissions?”
“Can I see the organisation grant for just one group?”
Tell an agent
List the group permission grants in organisation {organisation_pk}.
Show organisation {organisation_pk} permissions for group {group}.
POST /api/v1/organisations/{organisation_pk}/user-group-permissions/ Grant a group organisation-level permissions · Api v1 organisations user group permissions create #
Ask an LLM
“How do I let a team create projects across the organisation?”
“Can I give a group organisation-wide rights?”
Tell an agent
Grant group {group} organisation permissions {permissions} in {organisation_pk}.
Give team {group} organisation-wide access in organisation {organisation_pk}.
PUT /api/v1/organisations/{organisation_pk}/user-group-permissions/{id}/ Replace a group's organisation permissions · Api v1 organisations user group permissions update #
Ask an LLM
“Can I overwrite a team's organisation-level rights in one go?”
“What does replacing a group's organisation grant require?”
Tell an agent
Replace organisation group grant {id} in {organisation_pk} so group {group} has exactly {permissions}.
Overwrite team {group}'s organisation-wide grant {id} in {organisation_pk}.
PATCH /api/v1/organisations/{organisation_pk}/user-group-permissions/{id}/ Adjust part of a group's organisation grant · Api v1 organisations user group permissions partial update #
Ask an LLM
“Can I change just the permission list on a team's organisation grant?”
“Is it possible to patch a group's organisation rights without resending the group?”
Tell an agent
Patch organisation group grant {id} in {organisation_pk} to permissions {permissions}.
Point organisation grant {id} in {organisation_pk} at a different group, {group}.
DELETE /api/v1/organisations/{organisation_pk}/user-group-permissions/{id}/ Revoke a group's organisation permissions · Api v1 organisations user group permissions destroy #
Ask an LLM
“How do I strip a team's organisation-level rights?”
“Can I remove a group's organisation grant but keep the group itself?”
Tell an agent destructive · confirm first
Revoke organisation group grant {id} in {organisation_pk}.
Delete team permission record {id} at organisation level in {organisation_pk}.
GET /api/v1/organisations/{organisation_pk}/user-permissions/ List user permissions on an organisation · Api v1 organisations user permissions list #
Ask an LLM
“Which people hold organisation-level permissions directly?”
“What organisation rights does one particular user have?”
Tell an agent
List the individual user grants in organisation {organisation_pk}.
Show organisation {organisation_pk} permissions held by user {user}.
POST /api/v1/organisations/{organisation_pk}/user-permissions/ Grant a user organisation-level permissions · Api v1 organisations user permissions create #
Ask an LLM
“How do I give one person organisation-wide rights?”
“Can an individual user be allowed to create projects in the organisation?”
Tell an agent
Grant user {user} organisation permissions {permissions} in {organisation_pk}.
Give person {user} direct organisation-level access in {organisation_pk}.
PUT /api/v1/organisations/{organisation_pk}/user-permissions/{id}/ Replace a user's organisation permissions · Api v1 organisations user permissions update #
Ask an LLM
“Can I overwrite everything a person may do across the organisation?”
“What must a full replacement of a user's organisation grant include?”
Tell an agent
Replace organisation user grant {id} in {organisation_pk} so user {user} has exactly {permissions}.
Overwrite person {user}'s organisation-wide grant {id} in {organisation_pk}.
PATCH /api/v1/organisations/{organisation_pk}/user-permissions/{id}/ Adjust part of a user's organisation grant · Api v1 organisations user permissions partial update #
Ask an LLM
“Can I change only the permission keys on a person's organisation grant?”
“Is patching one user's organisation rights possible without resending the user?”
Tell an agent
Patch organisation user grant {id} in {organisation_pk} to permissions {permissions}.
Reassign organisation grant {id} in {organisation_pk} to person {user}.
DELETE /api/v1/organisations/{organisation_pk}/user-permissions/{id}/ Revoke a user's organisation permissions · Api v1 organisations user permissions destroy #
Ask an LLM
“How do I remove a person's direct organisation-level rights?”
“Does revoking a user's organisation grant remove them from the organisation?”
Tell an agent destructive · confirm first
Revoke organisation user grant {id} in {organisation_pk}.
Delete individual permission record {id} at organisation level in {organisation_pk}.
GET /api/v1/projects/{project_pk}/user-group-permissions/ List group permissions on a project · Api v1 projects user group permissions list #
Ask an LLM
“Which teams have access to this project?”
“What rights does each group hold on one project?”
Tell an agent
List the group permission grants on project {project_pk}.
Show which teams can work in project {project_pk} and with what rights.
POST /api/v1/projects/{project_pk}/user-group-permissions/ Grant a group access to a project · Api v1 projects user group permissions create #
Ask an LLM
“How do I give a team permissions across a whole project?”
“Can I make a group a project admin?”
Tell an agent
Grant group {group} permissions {permissions} on project {project_pk}.
Make team {group} a project admin ({admin}) in project {project_pk}.
GET /api/v1/projects/{project_pk}/user-group-permissions/{id}/ Get one group's project permission grant · Api v1 projects user group permissions retrieve #
Ask an LLM
“What exactly can a given team do in this project?”
“Is a specific group grant on a project an admin grant?”
Tell an agent
Show project group grant {id} in project {project_pk}.
Tell me whether team permission record {id} on project {project_pk} includes admin.
PUT /api/v1/projects/{project_pk}/user-group-permissions/{id}/ Replace a group's project permissions · Api v1 projects user group permissions update #
Ask an LLM
“Can I overwrite the full set of rights a team has on a project?”
“What must I resend to replace a group's project grant?”
Tell an agent
Replace project group grant {id} in {project_pk} so group {group} has exactly {permissions}.
Overwrite team {group}'s grant {id} on project {project_pk} with admin {admin}.
PATCH /api/v1/projects/{project_pk}/user-group-permissions/{id}/ Adjust part of a group's project grant · Api v1 projects user group permissions partial update #
Ask an LLM
“Can I just toggle admin on a team's project grant?”
“Is it possible to tweak a group's project rights without resending the group?”
Tell an agent
Patch project group grant {id} in {project_pk} to set admin {admin}.
Change only the permission list of team grant {id} on project {project_pk} to {permissions}.
DELETE /api/v1/projects/{project_pk}/user-group-permissions/{id}/ Revoke a group's project access · Api v1 projects user group permissions destroy #
Ask an LLM
“How do I take a team's access away from a project?”
“Can I drop one group's project grant while leaving its environment rights?”
Tell an agent destructive · confirm first
Revoke project group grant {id} in project {project_pk}.
Remove team permission record {id} from project {project_pk}.
GET /api/v1/projects/{project_pk}/user-permissions/ List user permissions on a project · Api v1 projects user permissions list #
Ask an LLM
“Which individual people have direct access to this project?”
“What rights does each user hold on one project?”
Tell an agent
List the individual user grants on project {project_pk}.
Show which people have direct permissions in project {project_pk}.
POST /api/v1/projects/{project_pk}/user-permissions/ Grant a user access to a project · Api v1 projects user permissions create #
Ask an LLM
“How do I give one person permissions on a project?”
“Can I make an individual user a project admin?”
Tell an agent
Grant user {user} permissions {permissions} on project {project_pk}.
Make person {user} an admin ({admin}) of project {project_pk}.
GET /api/v1/projects/{project_pk}/user-permissions/{id}/ Get one user's project permission grant · Api v1 projects user permissions retrieve #
Ask an LLM
“What can a specific person do in this project?”
“Does a given user grant on a project include admin?”
Tell an agent
Show project user grant {id} in project {project_pk}.
Tell me the rights in individual permission record {id} for project {project_pk}.
PUT /api/v1/projects/{project_pk}/user-permissions/{id}/ Replace a user's project permissions · Api v1 projects user permissions update #
Ask an LLM
“Can I overwrite everything a person is allowed to do in a project?”
“What does a full replacement of a user's project grant need?”
Tell an agent
Replace project user grant {id} in {project_pk} so user {user} has exactly {permissions}.
Overwrite person {user}'s grant {id} on project {project_pk} with admin {admin}.
PATCH /api/v1/projects/{project_pk}/user-permissions/{id}/ Adjust part of a user's project grant · Api v1 projects user permissions partial update #
Ask an LLM
“Can I just flip admin on for a person in a project?”
“Is a partial change to one user's project rights possible?”
Tell an agent
Patch project user grant {id} in {project_pk} to admin {admin}.
Change only the permission keys on person grant {id} in project {project_pk} to {permissions}.
DELETE /api/v1/projects/{project_pk}/user-permissions/{id}/ Revoke a user's project access · Api v1 projects user permissions destroy #
Ask an LLM
“How do I remove one person's direct access to a project?”
“Will revoking a user's project grant also drop their team-based project access?”
Tell an agent destructive · confirm first
Revoke project user grant {id} in project {project_pk}.
Delete the individual permission record {id} on project {project_pk}.

Specifications

⚙
OpenAPI
https://artifacts.apis.io/flagsmith/openapi/flagsmith-permissions-api-openapi.yml

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-permissions-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-permissions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Flagsmith Permissions API
  version: v1
  description: Flagsmith's Core and SDK APIs. Check out Flagsmith documentation.
  contact:
    email: support@flagsmith.com
  license:
    name: BSD License
    identifier: BSD-3-Clause
tags:


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