REST API User Management

Owned by Juliane Wetzel
Last updated: Apr 27, 2021
42 min read

INFO

Add the following command after the username and password to receive more meaningful HTTP errors:

-w"\n%{http_code}\n"

This command can be added to each call.

REST API Users

View All User Management

Request Method OPTIONS
Description

Returns an HTTP response in JSON representation with all information on available REST APIs for user management. Use this representation to understand the different commands you can execute for user management. Each REST API listed contains the path, method, and required parameters. You can use the REST APIs in this representation to change what is returned for the other calls in user management.

URI Syntax
curl -u '<username>:<password>' -X OPTIONS http://<Datameer-serverIP>:<port-number>/rest/user-management?pretty
Example Response
[
  {
    "addInternalGroup": {
      "path": "/rest/user-management/groups",
      "method": "POST",
      "params": [],
      "fields": [
        {
          "name": "name",
          "required": true,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255
          }
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "deleteInternalGroup": {
      "path": "/rest/user-management/groups/{name}",
      "pathVariables": [
        "name"
      ],
      "method": "DELETE",
      "params": [],
      "fields": []
    },
    "datameerVersion": "6.0.0"
  },
  {
    "findInternalGroups": {
      "path": "/rest/user-management/groups",
      "method": "GET",
      "params": [
        {
          "name": "firstResult",
          "required": false
        },
        {
          "name": "maxResults",
          "required": false
        },
        {
          "name": "sortBy",
          "required": false
        },
        {
          "name": "sortDir",
          "required": false
        },
        {
          "name": "fields",
          "required": false
        },
        {
          "name": "pretty",
          "required": false
        }
      ],
      "fields": [
        {
          "name": "name",
          "sortable": true
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "updateInternalGroup": {
      "path": "/rest/user-management/groups/{name}",
      "pathVariables": [
        "name"
      ],
      "method": "PUT",
      "params": [],
      "fields": [
        {
          "name": "name",
          "required": true,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255
          }
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "modifyInternalGroups": {
      "path": "/rest/user-management/groups",
      "method": "PUT",
      "params": [],
      "fields": [
        {
          "name": "affectedGroup",
          "required": true,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255
          }
        },
        {
          "name": "delete",
          "required": false,
          "type": {
            "name": "boolean"
          }
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "addRole": {
      "path": "/rest/user-management/roles",
      "method": "POST",
      "params": [],
      "fields": [
        {
          "name": "name",
          "required": true,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255
          }
        },
        {
          "name": "capabilities",
          "required": true,
          "type": {
            "name": "list",
            "min": 1,
            "max": 2147483647
          }
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "deleteRole": {
      "path": "/rest/user-management/roles/{name}",
      "pathVariables": [
        "name"
      ],
      "method": "DELETE",
      "params": [],
      "fields": []
    },
    "datameerVersion": "6.0.0"
  },
  {
    "findRoles": {
      "path": "/rest/user-management/roles",
      "method": "GET",
      "params": [
        {
          "name": "firstResult",
          "required": false
        },
        {
          "name": "maxResults",
          "required": false
        },
        {
          "name": "sortBy",
          "required": false
        },
        {
          "name": "sortDir",
          "required": false
        },
        {
          "name": "term",
          "required": false
        },
        {
          "name": "fields",
          "required": false
        },
        {
          "name": "pretty",
          "required": false
        }
      ],
      "fields": [
        {
          "name": "capabilities",
          "sortable": false
        },
        {
          "name": "name",
          "sortable": true
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "updateRole": {
      "path": "/rest/user-management/roles/{name}",
      "pathVariables": [
        "name"
      ],
      "method": "PUT",
      "params": [],
      "fields": [
        {
          "name": "name",
          "required": false,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255
          }
        },
        {
          "name": "capabilities",
          "required": false,
          "type": {
            "name": "list",
            "min": 1,
            "max": 2147483647
          }
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "addInternalUser": {
      "path": "/rest/user-management/users",
      "method": "POST",
      "params": [
        {
          "name": "notifyPerMail",
          "required": false
        }
      ],
      "fields": [
        {
          "name": "username",
          "required": true,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255,
            "regex": "/^[\\p{L}\\d_\\.+@~\\-\\(\\)]+(([ ]+[\\p{L}\\d_\\.+@~\\-\\(\\)]+)+)?$/"
          }
        },
        {
          "name": "email",
          "required": true,
          "type": {
            "name": "email"
          }
        },
        {
          "name": "roles",
          "required": true,
          "type": {
            "name": "list",
            "min": 1,
            "max": 2147483647
          }
        },
        {
          "name": "additionalInformation",
          "required": false,
          "type": {
            "name": "text",
            "min": 0,
            "max": 4096
          }
        },
        {
          "name": "enabled",
          "required": false,
          "type": {
            "name": "boolean"
          }
        },
        {
          "name": "expires",
          "required": false,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255,
            "regex": "/\\d{4}-\\d{2}-\\d{2}/"
          }
        },
        {
          "name": "groups",
          "required": false,
          "type": {
            "name": "list",
            "min": 0,
            "max": 2147483647
          }
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "deleteInternalUser": {
      "path": "/rest/user-management/users/{username}",
      "pathVariables": [
        "username"
      ],
      "method": "DELETE",
      "params": [],
      "fields": []
    },
    "datameerVersion": "6.0.0"
  },
  {
    "findInternalUsers": {
      "path": "/rest/user-management/users",
      "method": "GET",
      "params": [
        {
          "name": "firstResult",
          "required": false
        },
        {
          "name": "maxResults",
          "required": false
        },
        {
          "name": "sortBy",
          "required": false
        },
        {
          "name": "sortDir",
          "required": false
        },
        {
          "name": "term",
          "required": false
        },
        {
          "name": "fields",
          "required": false
        },
        {
          "name": "pretty",
          "required": false
        },
        {
          "name": "role",
          "required": false
        }
      ],
      "fields": [
        {
          "name": "additionalInformation",
          "sortable": false
        },
        {
          "name": "email",
          "sortable": true
        },
        {
          "name": "enabled",
          "sortable": true
        },
        {
          "name": "expires",
          "sortable": true
        },
        {
          "name": "groups",
          "sortable": false
        },
        {
          "name": "roles",
          "sortable": false
        },
        {
          "name": "username",
          "sortable": true
        },
        {
          "name": "lastLoginDate",
          "sortable": true
        },
        {
          "name": "loginCount",
          "sortable": true
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "findInternalUserByName": {
      "path": "/rest/user-management/users/{username}",
      "pathVariables": [
        "username"
      ],
      "method": "GET",
      "params": [],
      "fields": [
        {
          "name": "additionalInformation",
          "sortable": false
        },
        {
          "name": "email",
          "sortable": true
        },
        {
          "name": "enabled",
          "sortable": true
        },
        {
          "name": "expires",
          "sortable": true
        },
        {
          "name": "groups",
          "sortable": false
        },
        {
          "name": "roles",
          "sortable": false
        },
        {
          "name": "username",
          "sortable": true
        },
        {
          "name": "lastLoginDate",
          "sortable": true
        },
        {
          "name": "loginCount",
          "sortable": true
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "updateInternalUserPassword": {
      "path": "/rest/user-management/password/{username}",
      "pathVariables": [
        "username"
      ],
      "method": "PUT",
      "params": [
        {
          "name": "notifyPerMail",
          "required": false
        }
      ],
      "fields": []
    },
    "datameerVersion": "6.0.0"
  },
  {
    "updateInternalUser": {
      "path": "/rest/user-management/users/{username}",
      "pathVariables": [
        "username"
      ],
      "method": "PUT",
      "params": [
        {
          "name": "notifyPerMail",
          "required": false
        }
      ],
      "fields": [
        {
          "name": "email",
          "required": false,
          "type": {
            "name": "email"
          }
        },
        {
          "name": "additionalInformation",
          "required": false,
          "type": {
            "name": "text",
            "min": 0,
            "max": 4096
          }
        },
        {
          "name": "enabled",
          "required": false,
          "type": {
            "name": "boolean"
          }
        },
        {
          "name": "expires",
          "required": false,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255,
            "regex": "/\\d{4}-\\d{2}-\\d{2}/"
          }
        },
        {
          "name": "groups",
          "required": false,
          "type": {
            "name": "list",
            "min": 0,
            "max": 2147483647
          }
        },
        {
          "name": "roles",
          "required": false,
          "type": {
            "name": "list",
            "min": 1,
            "max": 2147483647
          }
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "updateInternalUsers": {
      "path": "/rest/user-management/users",
      "method": "PUT",
      "params": [],
      "fields": [
        {
          "name": "affectedUser",
          "required": true,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255,
            "regex": "/^[\\p{L}\\d_\\.+@~\\-\\(\\)]+(([ ]+[\\p{L}\\d_\\.+@~\\-\\(\\)]+)+)?$/"
          }
        },
        {
          "name": "additionalInformation",
          "required": false,
          "type": {
            "name": "text",
            "min": 0,
            "max": 4096
          }
        },
        {
          "name": "delete",
          "required": false,
          "type": {
            "name": "boolean"
          }
        },
        {
          "name": "email",
          "required": false,
          "type": {
            "name": "email"
          }
        },
        {
          "name": "enabled",
          "required": false,
          "type": {
            "name": "boolean"
          }
        },
        {
          "name": "expires",
          "required": false,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255,
            "regex": "/\\d{4}-\\d{2}-\\d{2}/"
          }
        },
        {
          "name": "groups",
          "required": false,
          "type": {
            "name": "list",
            "min": 0,
            "max": 2147483647
          }
        },
        {
          "name": "roles",
          "required": false,
          "type": {
            "name": "list",
            "min": 1,
            "max": 2147483647
          }
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "findAuthenticableUsers": {
      "path": "/rest/user-management/authenticable-users",
      "method": "GET",
      "params": [
        {
          "name": "firstResult",
          "required": false
        },
        {
          "name": "maxResults",
          "required": false
        },
        {
          "name": "sortBy",
          "required": false
        },
        {
          "name": "sortDir",
          "required": false
        },
        {
          "name": "term",
          "required": false
        },
        {
          "name": "role",
          "required": false
        },
        {
          "name": "fields",
          "required": false
        },
        {
          "name": "pretty",
          "required": false
        }
      ],
      "fields": [
        {
          "name": "additionalInformation",
          "sortable": false
        },
        {
          "name": "email",
          "sortable": true
        },
        {
          "name": "enabled",
          "sortable": true
        },
        {
          "name": "expires",
          "sortable": true
        },
        {
          "name": "groups",
          "sortable": false
        },
        {
          "name": "roles",
          "sortable": false
        },
        {
          "name": "username",
          "sortable": true
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "findShareableGroups": {
      "path": "/rest/user-management/shareable-groups",
      "method": "GET",
      "params": [
        {
          "name": "firstResult",
          "required": false
        },
        {
          "name": "maxResults",
          "required": false
        },
        {
          "name": "sortBy",
          "required": false
        },
        {
          "name": "sortDir",
          "required": false
        },
        {
          "name": "term",
          "required": false
        },
        {
          "name": "fields",
          "required": false
        },
        {
          "name": "pretty",
          "required": false
        }
      ],
      "fields": [
        {
          "name": "name",
          "sortable": true
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "findAvailableUsers": {
      "path": "/rest/user-management/available-users",
      "method": "GET",
      "params": [
        {
          "name": "group",
          "required": false
        },
        {
          "name": "firstResult",
          "required": false
        },
        {
          "name": "maxResults",
          "required": false
        },
        {
          "name": "sortBy",
          "required": false
        },
        {
          "name": "sortDir",
          "required": false
        },
        {
          "name": "term",
          "required": false
        },
        {
          "name": "fields",
          "required": false
        },
        {
          "name": "pretty",
          "required": false
        }
      ],
      "fields": [
        {
          "name": "additionalInformation",
          "sortable": false
        },
        {
          "name": "email",
          "sortable": true
        },
        {
          "name": "enabled",
          "sortable": true
        },
        {
          "name": "expires",
          "sortable": true
        },
        {
          "name": "groups",
          "sortable": false
        },
        {
          "name": "roles",
          "sortable": false
        },
        {
          "name": "username",
          "sortable": true
        },
        {
          "name": "lastLoginDate",
          "sortable": true
        },
        {
          "name": "loginCount",
          "sortable": true
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "findAuthenticatorUsers": {
      "path": "/rest/user-management/authenticator/users",
      "method": "GET",
      "params": [
        {
          "name": "firstResult",
          "required": false
        },
        {
          "name": "maxResults",
          "required": false
        },
        {
          "name": "sortBy",
          "required": false
        },
        {
          "name": "sortDir",
          "required": false
        },
        {
          "name": "term",
          "required": false
        },
        {
          "name": "fields",
          "required": false
        },
        {
          "name": "pretty",
          "required": false
        },
        {
          "name": "role",
          "required": false
        }
      ],
      "fields": [
        {
          "name": "additionalInformation",
          "sortable": false
        },
        {
          "name": "authenticableGroups",
          "sortable": false
        },
        {
          "name": "email",
          "sortable": true
        },
        {
          "name": "enabled",
          "sortable": true
        },
        {
          "name": "expires",
          "sortable": true
        },
        {
          "name": "groups",
          "sortable": false
        },
        {
          "name": "importedUser",
          "sortable": false
        },
        {
          "name": "roles",
          "sortable": false
        },
        {
          "name": "username",
          "sortable": true
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "findAuthenticatorUserByName": {
      "path": "/rest/user-management/authenticator/users/{username}",
      "pathVariables": [
        "username"
      ],
      "method": "GET",
      "params": [],
      "fields": [
        {
          "name": "additionalInformation",
          "sortable": false
        },
        {
          "name": "authenticableGroups",
          "sortable": false
        },
        {
          "name": "email",
          "sortable": true
        },
        {
          "name": "enabled",
          "sortable": true
        },
        {
          "name": "expires",
          "sortable": true
        },
        {
          "name": "groups",
          "sortable": false
        },
        {
          "name": "importedUser",
          "sortable": false
        },
        {
          "name": "roles",
          "sortable": false
        },
        {
          "name": "username",
          "sortable": true
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "overrideOwnEmailAndPassword": {
      "path": "/rest/user-management/logged-in-user",
      "method": "PUT",
      "params": [],
      "fields": [
        {
          "name": "email",
          "required": false,
          "type": {
            "name": "email"
          }
        },
        {
          "name": "currentPassword",
          "required": false,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255,
            "regex": "/[^\\s]+/m"
          }
        },
        {
          "name": "newPassword",
          "required": false,
          "type": {
            "name": "text",
            "min": 1,
            "max": 255,
            "regex": "/[^\\s]+/m"
          }
        }
      ]
    },
    "datameerVersion": "6.0.0"
  },
  {
    "findCapabilities": {
      "path": "/rest/user-management/capabilities",
      "method": "GET",
      "params": [
        {
          "name": "pretty",
          "required": false
        }
      ],
      "fields": []
    },
    "datameerVersion": "6.0.0"
  },
  {
    "loggedInUser": {
      "path": "/rest/user-management/logged-in-user",
      "method": "GET",
      "params": [
        {
          "name": "pretty",
          "required": false
        }
      ],
      "fields": []
    },
    "datameerVersion": "6.0.0"
  }

Logged In User Account Information

Request Method GET
Description

Returns account information about a specific Datameer X user.

URI Syntax
curl -u '<username>:<password>' -X GET http://<Datameer-serverIP>:<port-number>/rest/user-management/logged-in-user?pretty
Example Response
{
  "username": "admin",
  "email": "admin@localhost",
  "additionalInformation": "",
  "enabled": true,
  "expires": "",
  "groups": [IT-Dept.],
  "roles": ["ADMIN"],
  "capabilities": ["HADOOP_CLUSTER_ACCESS","EXPORTJOB_EDIT"],
  "internal": false,
  "lastLoginDate": "",
  "loginCount": 0
}
Additional Notes
 List of user capabilities:

ACCESS_TOKEN_CREATE - Allows to create access tokens for every user via REST API.

ADMINISTRATION_ACCESS - Allows access to the administration pages.

APP_MARKET_ACCESS - Allows access to the analytics application market.

ARCHIVE_PROJECT - Allows members of this role to create backups and restore entires projects.

CLUSTER_HEALTH_ACCESS - Allows access to the cluster health page.

CONNECTION_ACCESS - Allows to read connections.

CONNECTION_EDIT - Allows to create and write connections.

DATABASE_DRIVERS_ACCESS - Allows to administrate database drivers.

DATALINK_ACCESS - Allows to read data links.

DATALINK_EDIT - Allows to create, write, delete, and execute data links.

EMAIL_NOTIFICATION_SETUP - Allows to setup email notifications for job configurations.

EXPORTJOB_ACCESS - Allows to read export jobs.

EXPORTJOB_EDIT - Allows to create, write, and delete export jobs.

EXPORTJOB_EXECUTE - Allows to run export jobs.

FILEUPLOAD_ACCESS - Allows to read file uploads.

FILEUPLOAD_EDIT - Allows to create, write, and delete file uploads.

FILE_BROWSER_ACCESS - Allows access to the file browser

FOLDER_BACKUP - Allows members of this role to create a backup of a folder and download as a zip file.

FOLDER_CREATE - Allows to create folders or move existing folders into other folders.

FOLDER_CREATE_IN_HOME - Allows to create folders in the own home folder or move existing folders into another.

FOLDER_RESTORE - Allows members of this role to restore a folder form a zip file.

FOREIGN_ROLES_ACCESS - Allows access to roles the user does not belong to.

GROUPS_ACCESS - Allows access and modification of groups.

HADOOP_CLUSTER_ACCESS - Allows to administration the Hadoop cluster.

HADOOP_PROPERTIES_EDIT - Allows to configure Hadoop properties of job executions.

IMPORTJOB_ACCESS - Allows to read import jobs.

IMPORTJOB_DOWNLOAD - Allow to download import jobs result data.

IMPORTJOB_EDIT - Allows to create, write, and delete import jobs.

IMPORTJOB_EXECUTE - Allows to run import jobs.

INFOGRAPHICS_ACCESS - Allows to read infographics.

INFOGRAPHICS_EDIT - Allows to create, write, and delete infographics.

INFOGRAPHICS_SHARE_PUBLIC - Allows to publish infographics (read access to everyone).

JOB_DETAILS_ACCESS - Allows the user to access the common job details page.

JOB_HISTORY_ACCESS - Allows access to the job history page.

LICENSE_ACCESS - Allows access to the license page.

LICENSE_BUY_OR_ACTIVATE - Allows access to activate a license.

LICENSE_INFORMATION_ACCESS - Allows access to the license statistics.

LICENSE_UPLOAD - Allows to install a license.

MAIL_SERVER_ACCESS - Allows to administrate the mail server.

PLUGINS_ACCESS - Allows to view plug-ins.

PLUGINS_EDIT - Allows to administrate plug-ins.

ROLES_ACCESS - Allows to access roles.

ROLES_EDIT - Allows to create, update, and delete roles.

SHARE_WITH_FOREIGN_GROUPS_ACCESS - Allows to share with groups the user does not belong to.

SHARE_WITH_OTHERS_ACCESS - Allows to share with Others.

SYSTEM_DASHBOARD_ACCESS - Allows access to the system dashboard.

USERS_ACCESS - Allows access to users.

USERS_EDIT - Allows to create, update, and delete users.

USER_CAN_ACCESS_EVERYTHING - Allows to see every file or folder in the file system.

USER_CAN_EDIT_EVERYTHING - Allows to edit everything in the file system, including permissions, group sharing options, and ownership.

USER_MANAGEMENT_ACCESS - Bundles all user-related capabilities.

WORKBOOK_ACCESS - Allows to read workbooks.

WORKBOOK_DOWNLOAD - Allows to download workbook results data.

WORKBOOK_EDIT - Allows to create, write, and delete workbooks.

WORKBOOK_EXECUTE - Allows to run workbooks.

Create a User

Request Method POST
Description

Creates an internal user in Datameer.

URI Syntax
curl -u '<username>:<password>' -d '{username:"<user name>", email:"<user's email address>", roles : [<role>]}' -X POST http://<Datameer-serverIP>:<port-number>/rest/user-management/users
Example Response
{
  "version": "3.1",
  "username": "Robert",
  "email": "Robert@email.com",
  "enabled": true,
  "expires": "",
  "groups": [],
  "roles": [
    "ANALYST"
  ]
}
Additional Notes

Optional parameter:

    • notifyPerMail=true (sends an account creation email to user)

Mandatory fields:

    • username:"<username>"
    • email:"<email>"
    • roles: [<role_1>,...,<role_N>] > each role must exist

Optional fields:

    • groups:[<group_1>,..., <group_N>] > each group must exist
    • enabled:<true|false>
    • expires:"<yyyy-MM-dd>"
    • version:"<version>"

Send Notification When Creating a User

Request Method POST
Description

Creates a Datameer X user and emails the user a notification the account has been made.

URI Syntax
curl -u '<username>:<password>' -d '{version:"<version number>", username:"<user name>", email:"<user's email>", roles : [<role>]}' -X POST http://<Datameer-serverIP>:<port-number>/rest/user-management/users?notifyPerMail=true
Example Response
{
"version": "3.1",
"username": "RobertSmith",
"email": "RobertSmith@email.com",
"enabled": true,
"expires": "",
"groups": [],
"roles": [
"ANALYST"
]
}

List All Users

Request Method GET
Description

Returns a list of all the users and their information including Datameer X version, user name, email address, active/inactive, expiration date, groups and roles.

INFO

The information you see is configurable as per 'View all user management'. You can also return the information for a specified user.

URI Syntax

One user:

curl -u '<username>:<password>' -X GET http://<Datameer-serverIP>:<port-number>/rest/user-management/users/<user name>

First page of (ten) users:

curl -u '<username>:<password>' -X GET http://<Datameer-serverIP>:<port-number>/rest/user-management/users/

To see the next page of users:

curl -u '<username>:<password>' -X GET http://<Datameer-serverIP>:<port-number>/rest/user-management/users?firstResult=11

To increase the number of users per page, change the results value:

curl -u '<username>:<password>' -X GET http://<Datameer-serverIP>:<port-number>/rest/user-management/users?maxResults=50
Example Response

One user:

{
"username": "Frank",
"email": "Frank@email.com",
"additionalInformation": "",
"enabled": true,
"expires": "",
"groups": [],
"roles": ["ANALYST"],
"lastLoginDate": "",
"loginCount": 0,
"datameerVersion":"5.11.0"
}

All users:

{
  "firstResult": 0,
  "maxResults": 10,
  "total": 3,
  "elements": [
    {
      "username": "admin",
      "_links": {
        "self": {
          "href": "/rest/user-management/users/admin"
        },
        "delete": {
          "method": "DELETE",
          "permitted": false,
          "href": "/rest/user-management/users/admin"
        },
        "modify": {
          "method": "PUT",
          "permitted": true,
          "href": "/rest/user-management/users/admin"
        }
      }
    },
    {
      "username": "analyst",
      "_links": {
        "self": {
          "href": "/rest/user-management/users/analyst"
        },
        "delete": {
          "method": "DELETE",
          "permitted": true,
          "href": "/rest/user-management/users/analyst"
        },
        "modify": {
          "method": "PUT",
          "permitted": true,
          "href": "/rest/user-management/users/analyst"
        }
      }
    },
    {
      "username": "colin",
      "_links": {
        "self": {
          "href": "/rest/user-management/users/colin"
        },
        "delete": {
          "method": "DELETE",
          "permitted": true,
          "href": "/rest/user-management/users/colin"
        },
        "modify": {
          "method": "PUT",
          "permitted": true,
          "href": "/rest/user-management/users/colin"
        }
      }
    }
  ],
  "datameerVersion": "5.11.0"
}

Update a User

Request Method PUT
Description

Updates a Datameer X user's account.

URI Syntax
curl -u '<username>:<password>'-d '{version:"<version number>", email:"<user's email address>", roles : [<role>]}' -X PUT http://<Datameer-serverIP>:<port-number>/rest/user-management/users/<user name>
Example Response
{
"version": "3.1",
"username": "Robert",
"email": "RobertSmith@email.com",
"enabled": true,
"expires": "",
"groups": [],
"roles": [
"ANALYST"
]
}
Additional Notes

Optional fields:

    • roles: [<role_1>,...,<role_N>] > each role must exist
    • enabled:<true|false>
    • groups:[<group_1>,..., <group_N>] > each group must exist
    • expires:"<yyyy-MM-dd>"

Not supported fields:

    • username:"<username>"> username can never be changed

Import a User from External Authenticator

Request Method POST
Description

Adds a user in Datameer X taken from a 3rd party authenticator.

URI Syntax
curl -u '<username>:<password>' -d '{username:"<user name>", roles:[<role>]}' -X POST http://<Datameer-serverIP>:<port-number>/rest/user-management/users
Example Response
{
  "version": "3.1",
  "username": "Joel",
  "email": "Joel@email.com",
  "enabled": true,
  "expires": "",
  "groups": [
    "datameer"
  ],
  "roles": [
    "ANALYST"
  ]
}
Additional Notes

Mandatory fields:

    • username:"<username>"
    • roles: [<role_1>,...,<role_N>] > each role must exist

Optional fields:

    • enabled:<true|false>
    • version:"<version>"

Not supported fields:

    • email
    • groups
    • expires

Update a User Imported From an External Authenticator

Request Method PUT
Description

Updates a Datameer X user's account who authenticates from a 3rd party authenticator. 

URI Syntax
curl -u '<username>:<password>' -d '{roles : [<role>]}' -X PUT http://<Datameer-serverIP>:<port-number>/rest/user-management/users/<user name>
Example Response
{
  "version": "3.1",
  "username": "Joel",
  "email": "Joel@email.com",
  "enabled": true,
  "expires": "",
  "groups": [
    "datameer"
  ],
  "roles": [
    "ANALYST"
  ]
}
Additional Notes

Optional fields:

  • enabled:<true|false>
  • roles: [<role_1>,...,<role_N>] > each role must exist

Not supported fields:

  • email
  • groups
  • expires

Set or Update Password to Existing User

Request Method PUT
Description

Sets or updates a user password.

URI Syntax
curl -u '<username>:<password>'-d '<passowrd>' -X PUT http://<Datameer-serverIP>:<port-number>/rest/user-management/password/<user name>
Example Response

No confirmation/response

Send Notification When Setting or Updating a Password

Request Method PUT
Description

Sets or updates a user password. Sends a notification email to the user they password had been updated. 

URI Syntax
curl -u '<username>:<password>'-d '<password>' -X PUT http://<Datameer-serverIP>:<port-number>/rest/user-management/password/<user name>?notifyPerMail=true
Example Response

No confirmation/response


Delete a User

Request Method DELETE
Description

Deletes a user from Datameer.

URI Syntax
curl -u '<username>:<password>' -X DELETE http://<Datameer-serverIP>:<port-number>/rest/user-management/users/<user name>
Example Response

No confirmation/response

REST API Roles

Create a Role

Request Method POST
Description

Creates an internal role in Datameer. 

URI Syntax
curl -u '<username>:<password>'-X POST -d"{name:"test",capabilities:[list capabilities]}" http://<Datameer-serverIP>:<port-number>/rest/user-management/roles/
Example Response
{"name":"test",
"capabilities":["USERS_ACCESS","USER_MANAGEMENT_ACCESS","ADMINISTRATION_ACCESS"],
"datameerVersion":"6.1.0"}
Additional Notes
 Click here to expand...

The following role capabilities are possible:

ACCESS_TOKEN_CREATE - Allows to create access tokens for every user via REST API.

ADMINISTRATION_ACCESS - Allows access to the administration pages.

APP_MARKET_ACCESS - Allows access to the analytics application market.

ARCHIVE_PROJECT - Allows members of this role to create backups and restore entires projects.

CLUSTER_HEALTH_ACCESS - Allows access to the cluster health page.

CONNECTION_ACCESS - Allows to read connections.

CONNECTION_EDIT - Allows to create and write connections.

DATABASE_DRIVERS_ACCESS - Allows to administrate database drivers.

DATALINK_ACCESS - Allows to read data links.

DATALINK_EDIT - Allows to create, write, delete, and execute data links.

EMAIL_NOTIFICATION_SETUP - Allows to setup email notifications for job configurations.

EXPORTJOB_ACCESS - Allows to read export jobs.

EXPORTJOB_EDIT - Allows to create, write, and delete export jobs.

EXPORTJOB_EXECUTE - Allows to run export jobs.

FILEUPLOAD_ACCESS - Allows to read file uploads.

FILEUPLOAD_EDIT - Allows to create, write, and delete file uploads.

FILE_BROWSER_ACCESS - Allows access to the file browser

FOLDER_BACKUP - Allows members of this role to create a backup of a folder and download as a zip file.

FOLDER_CREATE - Allows to create folders or move existing folders into other folders.

FOLDER_CREATE_IN_HOME - Allows to create folders in the own home folder or move existing folders into another.

FOLDER_RESTORE - Allows members of this role to restore a folder form a zip file.

FOREIGN_ROLES_ACCESS - Allows access to roles the user does not belong to.

GROUPS_ACCESS - Allows access and modification of groups.

HADOOP_CLUSTER_ACCESS - Allows to administration the Hadoop cluster.

HADOOP_PROPERTIES_EDIT - Allows to configure Hadoop properties of job executions.

IMPORTJOB_ACCESS - Allows to read import jobs.

IMPORTJOB_DOWNLOAD - Allow to download import jobs result data.

IMPORTJOB_EDIT - Allows to create, write, and delete import jobs.

IMPORTJOB_EXECUTE - Allows to run import jobs.

INFOGRAPHICS_ACCESS - Allows to read infographics.

INFOGRAPHICS_EDIT - Allows to create, write, and delete infographics.

INFOGRAPHICS_SHARE_PUBLIC - Allows to publish infographics (read access to everyone).

JOB_DETAILS_ACCESS - Allows the user to access the common job details page.

JOB_HISTORY_ACCESS - Allows access to the job history page.

LICENSE_ACCESS - Allows access to the license page.

LICENSE_BUY_OR_ACTIVATE - Allows access to activate a license.

LICENSE_INFORMATION_ACCESS - Allows access to the license statistics.

LICENSE_UPLOAD - Allows to install a license.

MAIL_SERVER_ACCESS - Allows to administrate the mail server.

PLUGINS_ACCESS - Allows to view plug-ins.

PLUGINS_EDIT - Allows to administrate plug-ins.

ROLES_ACCESS - Allows to access roles.

ROLES_EDIT - Allows to create, update, and delete roles.

SHARE_WITH_FOREIGN_GROUPS_ACCESS - Allows to share with groups the user does not belong to.

SHARE_WITH_OTHERS_ACCESS - Allows to share with Others.

SYSTEM_DASHBOARD_ACCESS - Allows access to the system dashboard.

USERS_ACCESS - Allows access to users.

USERS_EDIT - Allows to create, update, and delete users.

USER_CAN_ACCESS_EVERYTHING - Allows to see every file or folder in the file system.

USER_CAN_EDIT_EVERYTHING - Allows to edit everything in the file system, including permissions, group sharing options, and ownership.

USER_MANAGEMENT_ACCESS - Bundles all user-related capabilities.

WORKBOOK_ACCESS - Allows to read workbooks.

WORKBOOK_DOWNLOAD - Allows to download workbook results data.

WORKBOOK_EDIT - Allows to create, write, and delete workbooks.

WORKBOOK_EXECUTE - Allows to run workbooks.

List All Roles

Request Method GET
Description

Returns a list of all the created role names in Datameer.

URI Syntax
curl -u '<username>:<password>' -X GET http://<Datameer-serverIP>:<port-number>/rest/user-management/roles
Example Response
{
"name": "ADMIN"
},
{
"name": "ANALYST"
},
{
"name": "App Operator"
},
{
"name": "News"
},
{
"name": "Illustrator"
},
{
"name": "ANALYST2"
},
{
"name": "ANALYST3"
},
{
"name": "VARIABLES_EDIT"
},
{
"name": "VARIABLES_READ"
}

Update a Role

Request Method PUT
Description

Updates an internal role in Datameer.

URI Syntax
curl -u '<username>:<password>'-X PUT -d "{name:"name",capabilities:[capabilties]}" http://<Datameer-serverIP>:<port-number>/rest/user-management/roles/<role-name>
Example Response
{"name":"tests",
"capabilities["WORKBOOK_DOWNLOAD","EXPORTJOB_EXECUTE","EXPORTJOB_ACCESS","IMPORTJOB_ACCESS","WORKBOOK_EXECUTE","SHARE_WITH_FOREIGN_GROUPS_ACCESS","CONNECTION_ACCESS","FOLDER_CREATE","ARCHIVE_PROJECT",
"FOLDER_CREATE_IN_HOME","IMPORTJOB_EXECUTE","FILEUPLOAD_EDIT","INFOGRAPHICS_SHARE_PUBLIC","FILE_BROWSER_ACCESS","WORKBOOK_ACCESS","FOLDER_BACKUP","DATALINK_ACCESS","FILEUPLOAD_ACCESS","EXPORTJOB_EDIT",
"IMPORTJOB_EDIT","INFOGRAPHICS_ACCESS","SHARE_WITH_OTHERS_ACCESS","CONNECTION_EDIT","IMPORTJOB_DOWNLOAD","WORKBOOK_EDIT","USER_CAN_ACCESS_EVERYTHING","USER_CAN_EDIT_EVERYTHING","DATALINK_EDIT",
"FOLDER_RESTORE","INFOGRAPHICS_EDIT"]

Delete a Role

Request Method DELETE
Description

Deletes an internal role in Datameer.

URI Syntax
curl -u '<username>:<password>'-X DELETE http://<Datameer-serverIP>:<port-number>/rest/user-management/roles/<role-name>
Example Response

No confirmation/response

REST API Groups

Create a Group

Request Method POST
Description

Creates an internal group in Datameer.

INFO

This REST API call is only available if you use an internal authenticator or a mixed-mode authenticator. This call doesn't work if you use LDAP or SAML authentication and the internal authenticator is disabled.

URI Syntax
curl -u '<username>:<password>'-X POST -d '{name:"group"}' http://<Datameer-serverIP>:<port-number>/rest/user-management/groups/
Example Response
{"name":"testgroup",
"datameerVersion":"10.1.0"}

List All Groups

Request Method GET
Description

Returns a list of all the created group names in Datameer.

URI Syntax
curl -u '<username>:<password>' -X GET http://<Datameer-serverIP>:<port-number>/rest/user-management/groups
Example Response
{
    "name": "datameer"
  },
  {
    "name": "group 1"
  },
  {
    "name": "group 2"
  },
  {
    "name": "group 3"
  },
  {
    "name": "Shark Team"
  },
  {
    "name": "Special Team"
  }

Update a Group

Request Method PUT
Description

Updates an internal group in Datameer.

INFO

This REST API call is only available if you use an internal authenticator or a mixed-mode authenticator. This call doesn't work if you use LDAP or SAML authentication and the internal authenticator is disabled.

URI Syntax

INFO: If your file name includes " " (empty spaces), replace those spaces with "+".

curl -u '<username>:<password>'-X PUT -d '{name:"group"}' http://<Datameer-serverIP>:<port-number>/rest/user-management/groups/<group-name>
Example Response
{"name":"group",
"datameerVersion":"10.1.0"}

Delete a Group

Request Method DELETE
Description

Deletes an internal group in Datameer.

INFO

This REST API call is only available if you use an internal authenticator or a mixed-mode authenticator. This call doesn't work if you use LDAP or SAML authentication and the internal authenticator is disabled.

URI Syntax
curl -u '<username>:<password>'-X DELETE http://<Datameer-serverIP>:<port-number>/rest/user-management/groups/<group-name>
Example Response

No confirmation/response