List user group roles

Request

This endpoint provides list of roles assigned to the usergroup.

Security

Bearer

Path

companyIdstring, (uuid)required

Company ID of the user group.

Example:1234a66b-7493-4f41-908c-58ba81093653

groupIdstring, (uuid)required

Identifier for the user group.

Example:4974a66b-7493-4f41-908c-58ba81093947

Bodyapplication/jsonrequired

searchTextstring

Query text to search roles. The match would be case-insensitive.

Example:"Admin"

paginationobject(OffsetBasedPaginationRequestParams)required

Pagination information for request.

sortParamsobject(RoleSortParams)

Sorting related parameters.

filtersArray of objects(ListRoleFilter)

List of filters. Roles matching with any filter would be returned.

curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v3/companies/1234a66b-7493-4f41-908c-58ba81093653/user-groups/4974a66b-7493-4f41-908c-58ba81093947/roles \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "searchText": "Admin",
    "pagination": {
      "offset": 0,
      "limit": 100
    },
    "sortParams": {
      "sortBy": "NAME",
      "sortOrder": "DESC"
    },
    "filters": [
      {
        "roleIds": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "roleProvidedBy": [
          "PLATFORM"
        ]
      }
    ]
  }'

Responses

OK

Bodyapplication/json

rolesArray of objects(RoleScope)required

Roles assigned to the group matching with the request.

paginationobject(PaginationResponseParams)required

Pagination information for response.

Response

{
  "roles": [
    { … }
  ],
  "pagination": {
    "totalNumResults": 0
  }
}