API

Reset a role to the default

DELETEhttps://lemurseye.com/api/v1/roles/{id}/permissions

Drops your company's changes to a role: it holds the LemursEye default permissions again. Deletes nothing else, and nobody loses the role. No body.

Permission: roles:manage (a person only, never an API key). The token is sent as Authorization: Bearer <token>; see Authentication.

Path parameters

idstringrequired
The role: owner, manager, viewer or installer.

Response

200

The role with its default permissions, customised: false.

Errors

Where a message is listed, it comes back as JSON: { "error": "..." }. Otherwise only the status code is returned.

404
No company role with this id.
401
No token, or it has expired.
403
The token lacks the permission above.

curl --request DELETE \
  --url https://lemurseye.com/api/v1/roles/viewer/permissions \
  --header "Authorization: Bearer $LEMURSEYE_TOKEN"

Response200

{
  "id": "viewer",
  "slug": "viewer",
  "tenantId": null,
  "name": "Viewer",
  "description": "Reads the map, history, money and reports. Changes nothing.",
  "scope": "tenant",
  "builtIn": true,
  "permissions": [
    "fleet:read",
    "device:read",
    "trips:read",
    "money:read",
    "reports:read",
    "alerts:read",
    "geofence:read",
    "settings:read",
    "modules:read",
    "dispatch:read",
    "drivers:read"
  ],
  "userCount": 4,
  "customised": false
}

← Change a role's permissions