Use the Users API to inspect enabled users and their effective roles in each team in your organization.

Read team roles

Each entry in data.relationships.teams.data includes a meta.roles array of role identifiers. With team-specific roles enabled, these are the user's assigned roles for that team. Otherwise, the array contains the legacy organization role.

For example, this synthetic team relationship identifies two roles on one team:

{
  "id": "42",
  "type": "team",
  "meta": {
    "roles": ["admin", "user"]
  }
}

The deprecated organization_role attribute remains for compatibility. Use each team's meta.roles to interpret team roles. Role identifiers can include custom roles configured for your organization.

See Role management and permissions for how roles combine and how to change assignments in GrowthLoop.