# Update Role Scopes API

API to update scopes of an roles for the tenant

Endpoint: PUT /authz2/v1/roles/{role_id}/scopes
Version: 1.0.0
Security: apiKey

## Path parameters:

  - `role_id` (string, required)
    Role ID

## Request fields (application/json):

  - `scope_ids` (array)

  - `scope_names` (array)
    Enum: "read:device", "read:group", "read:blueprint", "read:directory_record", "create:device_command:SET_DEVICE_LOCKDOWN_STATE", "create:device_command:REBOOT", "create:device_command:BEEP_DEVICE", "create:device_command:WIPE", "create:device_command:UPDATE_HEARTBEAT", "create:device_command:NOTIFY_DEVICE", "create:device_command:LOCK", "create:device_command:SET_KIOSK_APP", "update:device:group", "create:device:tag", "update:device:tag", "delete:device:tag", "update:device:alias", "create:template_upgrade", "create:device_command:SET_STREAM_VOLUME", "create:device_command:SET_BRIGHTNESS_SCALE", "create:device_command:SET_ROTATION_STATE", "create:device_command:SET_SCREEN_OFF_TIMEOUT", "create:device_command:SET_WALLPAPER", "create:device_command:SET_WIFI_STATE", "create:device_command:ADD_WIFI_AP", "create:device_command:REMOVE_WIFI_AP", "create:device_command:SET_STATIC_IP", "create:device_command:SET_ETHERNET_SETTINGS", "create:device_command:SET_GPS_STATE", "create:device_command:SET_BLUETOOTH_STATE", "create:device_command:SET_TIMEZONE", "create:device_command:SET_ADB_STATE", "create:device_command:UPDATE_DEVICE_CONFIG", "create:device_command:UPDATE_BLUEPRINT", "create:device_command:SHUT_DOWN", "create:device_command:CLEAR_PASSCODE", "create:device_command:LOST_MODE", "read:device_app", "create:device_command:REFRESH_APPLIST", "create:device_command:INSTALL", "create:device_command:INSTALL_APP", "create:device_command:UNINSTALL", "create:device_command:UNINSTALL_APP", "create:device_command:SET_APP_STATE", "create:device_command:CLEAR_APP_DATA", "create:device_command:SET_APP_PERMISSION", "create:device_command:REQUEST_BUGREPORT", "create:device_command:SET_NEW_POLICY", "create:group_command:SET_NEW_POLICY", "create:group", "create:group_command:REBOOT", "create:group_command:LOCK", "create:group_command:UPDATE_HEARTBEAT", "create:group_command:WIPE", "create:group_command:NOTIFY_DEVICE", "create:group_command:SET_KIOSK_APP", "create:group_command:SET_STREAM_VOLUME", "create:group_command:SET_BRIGHTNESS_SCALE", "create:group_command:SET_ROTATION_STATE", "create:group_command:SET_SCREEN_OFF_TIMEOUT", "create:group_command:SET_WALLPAPER", "create:group_command:SET_WIFI_STATE", "create:group_command:ADD_WIFI_AP", "create:group_command:REMOVE_WIFI_AP", "create:group_command:SET_STATIC_IP", "create:group_command:SET_ETHERNET_SETTINGS", "create:group_command:SET_GPS_STATE", "create:group_command:SET_BLUETOOTH_STATE", "create:group_command:SET_TIMEZONE", "create:group_command:SET_ADB_STATE", "create:group_command:UPDATE_DEVICE_CONFIG", "create:group_command:UPDATE_BLUEPRINT", "create:group_command:INSTALL", "create:group_command:INSTALL_APP", "create:group_command:UNINSTALL", "create:group_command:UNINSTALL_APP", "create:group_command:SET_APP_STATE", "create:device_command:INITIATE_OFFER", "read:device_screenshot", "create:device_command:CAPTURE_SCREENSHOT", "create:device_screenshot", "read:device_graph", "read:event_feed", "create:blueprint", "update:blueprint", "delete:blueprint", "create:device_command:CONVERGE", "update:device:blueprint", "update:group:blueprint", "provision:device", "read:compliance_policy", "create:compliance_policy", "update:compliance_policy", "delete:compliance_policy", "read:provisioning_template", "create:provisioning_template", "update:provisioning_template", "delete:provisioning_template", "create:provisioning_template:imei_serial", "update:provisioning_template:imei_serial", "delete:provisioning_template:imei_serial", "update:provisioning_template:wifi_management", "read:app", "read:emm", "create:emm", "update:emm", "create:app:esper_android", "update:app:esper_android", "delete:app:esper_android", "read:alert", "read:pipeline", "read:geofence", "read:report", "create:report", "read:personal_access_token", "create:personal_access_token", "update:personal_access_token", "delete:personal_access_token", "read:foundation_build", "read:foundation_device_model", "update:foundation_build", "update:foundation_device_model", "read:foundry_event", "update:command", "read:user:group", "create:app:esper_ios", "update:app:esper_ios", "delete:app:esper_ios", "create:operation:CONVERGE", "create:operation:REBOOT", "create:operation:INSTALL", "create:operation:UNINSTALL", "create:operation:APP_INSTALL", "create:operation:APP_UNINSTALL", "read:operation", "update:operation", "read:operation:devices", "read:device:operations", "update:operation:devices", "create:device_command:RUN_SHELL_SCRIPT", "create:remote_terminal", "read:report:query", "create:report:query", "read:report:saved_query", "create:report:saved_query", "update:report:saved_query", "delete:report:saved_query", "create:device_command:REMOVE_DEVICE", "read:report:ingest", "create:report:ingest", "read:esper_apps", "create:device_command:RUN_CUSTOM_ACTION", "create:device_command:LIST_RESTRICTED_PROFILES", "create:device_command:LIST_PROVISIONING_PROFILES", "create:group_command:SYNC_CONTENT", "create:device_command:SYNC_CONTENT"

## Response 200 fields (application/json):

  - `count` (integer)

  - `scopes` (array)

  - `scopes.id` (string)

  - `scopes.name` (string)

  - `scopes.description` (string)

  - `scopes.scope_type` (integer)

## Response 400 fields (application/json):

  - `status` (integer)
    Either 'status' or 'code' will be present, but not both.

  - `code` (integer)
    Either 'status' or 'code' will be present, but not both.

  - `error` (string)
    Either 'error' or 'errors' will be present, but not both.

  - `errors` (array)
    Either 'error' or 'errors' will be present, but not both.

  - `message` (string)

## Response 401 fields (application/json):

  - `status` (integer)
    Either 'status' or 'code' will be present, but not both.

  - `code` (integer)
    Either 'status' or 'code' will be present, but not both.

  - `error` (string)
    Either 'error' or 'errors' will be present, but not both.

  - `errors` (array)
    Either 'error' or 'errors' will be present, but not both.

  - `message` (string)