Organizations

ListRolesByOrgIDAndUXPurpose

Returns custom roles for an organization filtered by their UX purpose (e.g., 'organization', 'team', or 'token'). This allows the UI to display only the roles relevant to the current context, such as showing only organization-level roles when managing member access. By default, results are limited to roles whose permissions are contained within the calling user's own permissions; set the 'assignedToMe' query parameter to instead list only the roles the calling user holds.

get/api/orgs/{orgName}/roles

Request

  • Base URL: https://api.pulumi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pulumi.com/api/orgs/{orgName}/roles
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

Query parameters

assignedToMeboolean

When true, returns only the roles the calling user holds — assigned to them directly, through a team membership, or as the organization default role — rather than all roles contained within the calling user's permissions. Defaults to false.

uxPurpose'role' | 'role_private' | 'role_temporary' | 'policy' | 'set' required

Filter roles by their UX purpose

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.