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

Browser not supported