Netskope LogoNetskope Logo
  • Security Services
  • AI Services
  • Networking Services
  • Analytics Services
  • Integrations
  • getting-started.svgGetting Started
    • Support
    • Community
    • Netskope.com
    © 2026 All Rights Reserved. Netskope Inc.
    Home
    REST API
    Netskope Platform API Endpoints for REST API v1
    Manage User Roles
    List User Roles

    List User Roles

    Important

    This Netskope REST API v1 endpoint will be retired on 10/15/2024. Refer to End of Life (EOL) for Specific REST API v1 Endpoints for more details.

    This endpoint lists all user roles.

    Request Endpoint

    https://<tenant-URL>/api/v1/role?op=list

    Valid parameters are:

    KeyTypeValueDescription
    tokenstringEx:

    f32a973eddd7bc1602fc0dc0a

    Required. The token obtained from the REST API page in the Netskope UI ( Settings > Tools > Rest API v1) is required. We recommend that you place the token in the body of the request, not in the endpoint URL.
    opstringlistRequired. Operation performed.
    typestringcustom | predefinedOptional. Specifies type of role to be listed. Default is all types.

    Example List User Roles Request

    POST 'https://<tenant-URL>/api/v1/role?op=list' 
    --header 'Content-Type: application/json' 
    --data-raw '{
        "token": "f32a973eddd7bc1602fc0f48dc0a", 
        "type": "custom",
    }
    In this Topic
    • List User Roles