Software Secure Workload
Activity Configure

Secure Workload OpenAPIs Roles Get roles

Last updated: Jun 09, 2025

Get roles

This endpoint returns a list of roles accessible to the user. Roles can be filtered to a given root scope. If no scope if provided, all roles, for all scopes the user has access to, are returned. Service provider roles will only be returned if the user is a site admin.

GET /openapi/v1/roles

Parameters:

Name

Type

Description

app_scope_id

string

(optional) ID of a root scope to return roles only assigned to that scope.

Response object: Returns a list of user role objects.

Sample python code


  resp = restclient.get('/roles')