For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
13.5kProductPricingSign inStart free trialBook a demo
DocsAPIsSDKsEnterprise EdgeGuidesAcademyRelease notes
DocsAPIsSDKsEnterprise EdgeGuidesAcademyRelease notes
    • API overview
  • Client API
  • Frontend API
  • Admin API
      • GETGet a list of all projects.
      • POSTCreate project
      • POSTValidate project ID
      • PUTUpdate project
      • DELDelete project
      • PUTUpdate project enterprise settings
      • POSTArchive project
      • POSTRevive project
      • GETGet users and groups in project
      • POSTConfigure project access
      • PUTSet users and groups to roles in the current project
      • GETGet project-role mappings
      • PUTSets roles for user
      • DELRemove project access for a user
      • PUTSets roles for group
      • DELRemove project access for a group
      • GET[BETA] List action sets.
      • POST[BETA] Create an action set.
      • PUT[BETA] Update an action set.
      • DEL[BETA] Delete an action set.
      • POST[BETA] Enables an action set.
      • POST[BETA] Disables an action set.
      • GET[BETA] Get action events for a specific action set.
      • GET[BETA] Configuration for the actions UI.
      • GETGet an overview of a project.
      • GETGet an overview project dora metrics.
      • GETGet a list of all applications for a project.
      • GETGet a list of all flag creators for a project.
      • GETGet outdated project SDKs
      • POSTAdd an environment to a project.
      • DELRemove an environment from a project.
      • POSTSet environment-default strategy
      • GETGet a health report for a project.
      • GETGet api tokens for project.
      • POSTCreate a project API token.
      • DELDelete a project API token.
      • GETGet an overview of a project insights.
      • GET[BETA] Get project status
      • GET[BETA] Get personal dashboard
      • GET[BETA] Get personal project details

Unleash reduces the risk of releasing new features, drives innovation by streamlining the software release process, and increases revenue by optimizing end-user experience. While we serve the needs of the world's largest, most security-conscious organizations, we are also rated the “Easiest Feature Management system to use” by G2.

GitHubGitHubLinkedInLinkedInX (Twitter)X (Twitter)SlackSlackStack OverflowStack OverflowYouTubeYouTube

Server SDKs

  • Node.js
  • Java
  • Go
  • Rust
  • Ruby
  • Python
  • .NET
  • PHP
  • All SDKs

Frontend SDKs

  • JavaScript
  • React
  • Next.js
  • Vue
  • iOS
  • Android
  • Flutter

Feature Flag use cases

  • Secure, scalable feature flags
  • Rollbacks
  • FedRAMP, SOC2, ISO2700 compliance
  • Progressive or gradual rollouts
  • Trunk-based development
  • Software kill switches
  • A/B testing
  • Feature management
  • Canary releases

Product

  • Quickstart
  • Unleash architecture
  • Pricing
  • Product vision
  • Open live demo
  • Open source
  • Enterprise feature management platform
  • Unleash vs LaunchDarkly

Support

  • Help center
  • Status
  • Changelog
Made in a cosy atmosphere in the Nordic countries.Copyright © 2026 Unleash
LogoLogo
13.5kProductPricingSign inStart free trialBook a demo
Admin APIProjects

Get project-role mappings

||View as Markdown|
GET
https://app.unleash-instance.example.com/api/admin/projects/roles/:roleId/access
GET
/api/admin/projects/roles/:roleId/access
$curl https://app.unleash-instance.example.com/api/admin/projects/roles/roleId/access \
>     -H "Authorization: <apiKey>" \
>     -H "Content-Type: application/json"
1{
2  "projects": [
3    {
4      "project": "mobile-app",
5      "role": 5,
6      "userCount": 12,
7      "serviceAccountCount": 3,
8      "groupCount": 2
9    },
10    {
11      "project": "web-portal",
12      "role": 5,
13      "userCount": 8,
14      "serviceAccountCount": 1,
15      "groupCount": 4
16    }
17  ]
18}

Enterprise feature

For the provided role, retrieves a list of projects that use this role. For each project it also contains information about how the role used in that project, such as how many users, groups, or service accounts that use the role.

Was this page helpful?
Previous

Sets roles for user

Next
Built with

Authentication

Authorizationstring
API key needed to access this API
OR
AuthorizationBearer
API key needed to access this API, in Bearer token format

Path parameters

roleIdstringRequired

Response

projectRoleUsageSchema
projectslist of objects
A collection of projects with counts of users and groups mapped to them with specified roles.

Errors

401
Unauthorized Error
403
Forbidden Error