Roles

List Organization Roles Endpoint

get

Endpoint to list roles of an organization.

Args: organization_id: Organization id. name: Name of the role to filter by. user_id: User ID to filter by. team_id: Team ID to filter by. resource: Resource to filter by. action: Action to filter by. system_managed: Filter by the system managed property. type: Type of the role to filter by. level: Level of the role to filter by. assigned_to_current_user: If True, only include roles assigned to the current user. workspace_scope: Scope at which the role is assigned. project_scope: Scope at which the role is assigned. offset: Offset for pagination. limit: Limit for pagination. user: Authenticated user. rbac: RBAC component.

Raises: ValueError: If both user_id and assigned_to_current_user are set.

Returns: List of all roles matching the given filters.

Authorizations

Path parameters

organization_idstring · uuidRequired

Query parameters

namestringOptional

user_idstring · uuidOptional

team_idstring · uuidOptional

resourcestringOptional

actionstringOptional

system_managedbooleanOptional

typeall ofOptionalDefault: normal

Enum that represents the type of a role.

levelstring · enum[]Optional

Scope levels.

assigned_to_current_userbooleanOptionalDefault: false

workspace_scopestring · uuidOptional

project_scopestring · uuidOptional

offsetintegerOptionalDefault: 0

limitinteger · max: 100OptionalDefault: 100

Responses

application/json

object[]Optional

Model for viewing roles.

application/json

get

HTTPcURLJavaScriptPython

GET /organizations/{organization_id}/roles HTTP/1.1
Host: 
Accept: */*

[
  {
    "name": "text",
    "description": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "organization_id": "123e4567-e89b-12d3-a456-426614174000",
    "level": "organization",
    "system_managed": true,
    "type": "normal"
  }
]