Viewpoint Users REST APIs | Supported Operations | Teradata Viewpoint - Supported Operations - Teradata Data Lab - Teradata Viewpoint

Teradata® Viewpoint and Teradata® Data Lab API Reference Guide - 23.04

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
Lake
VMware
Product
Teradata Data Lab
Teradata Viewpoint
Release Number
23.04
Published
April 2023
Language
English (United States)
Last Update
2023-05-05
dita:mapPath
tvo1678987866029.ditamap
dita:ditavalPath
ft:empty
dita:id
B035-2215
Product Category
Analytical Ecosystem
HTTP URL Parameters Description Response
GET /api/public/users Optional Parameters
  • username: String used to limit results to users that starts with provided username case insensitivity.
  • role: String used to limit results to users with roles that starts with provided role case insensitivity.
  • perPage: Number of users to return per page. Default is 100. The upper limit is 500.
  • page: The page number to return. Default is 1.
Provide a list of all users A list of users
POST /api/public/users
Required Parameters
  • username
  • firstName
  • lastName
  • email
Optional Parameters
  • externallyAuthenticated
  • password
  • timeZone
  • locale
  • roles
Add a new User to Viewpoint. The new user can be either externally authenticated or local.
If the viewpoint user submitting the request has the role: VP_User_Manager, only own role or roles created by it can be added to the new user.

When successful, the response will be OK.

When unsuccessful, the response will be 400 for bad requests and 401 for unauthorized requests.

GET /api/public/users/{username} username in url Get a user from Viewpoint

When successful, the response will be OK.

When unsuccessful, the response will be 400 for bad requests, 401 for unauthorized requests, or 404 NOT Found if there is no such user.

PUT /api/public/users/{username}
Path Variable
  • username
Required Parameters
  • firstName
  • lastName
  • email
Optional Parameters
  • externallyAuthenticated
  • password
  • timeZone
  • locale
  • roles
Update the specified user. The full state of the user must be provided in the request, with the following exceptions:
  • If the password is omitted or set to null, the user's password will not be updated
  • If the list of roles is omitted or set to null, the user's roles will not be updated
The username should not be included in the request.
If the viewpoint user submitting the request has the role: VP_User_Manager, only own role or roles created by it can be added to the existing user. Existing roles which are not owned by VP_User_Manager remains unchanged.

When successful, the response will be OK.

When unsuccessful, the response will be 400 for bad requests and 401 for unauthorized requests.

PUT /api/public/users/{username}?changePassword
Path Variable
  • username
Required Parameter
  • password
Password change
  • Case 1: User can change their own password. username as path parameter, new password is required. (Authorization Header should be the username:password of the user requesting the API)
  • Case 2: User with Administrator role can change another User's password. username is required, new password is required.

When successful, the response will be OK.

When unsuccessful, the response will be 400 for bad requests and 401 for unauthorized requests.

DELETE /api/public/users/{username} Path Variable
  • username
Delete an existing user from Viewpoint When successful, the response will be OK
DELETE /api/public/users/audit/{username} Path Variable
  • username
Delete user details audit trail for a user When successful, the response will be OK