Users Service: Overview

The Users service provides operations for managing users in the platform, such as adding, modifying, and deleting users and retrieving user information.

Note: to return a list of all users, use the GET search operation (Search service).

Note: Most of these operations take the UserID as a parameter. The UserID is returned in the response to the POST /api/login operation (userFDN parameter in the response body). If you're a Site Admin you can also use the GET /api/search operation with user parameter (GET /api/search?q=type:user) to return a list of users.

URL: https://{hostname}/api/users

Action Endpoint Description
add top API POST /api/users/{UserID}/topapis

Adds an API to a user's Top APIs list.

Valid in version: 2020.1.0 and later.

add user POST /api/users Allows the Site Admin to add a new user to the platform.
change notification state PUT /api/users/{UserID}/notifications/{NotificationID}/state Changes the state of a user's notification (for example, archived, read).
change notifications state PUT /api/users/{UserID}/notifications/state Allows deletion (archiving) of multiple user notifications.
change signup state PUT /api/users/{UserID}/registration/state Changes the signup state for the specified user.
change status PUT /api/users/{UserID}/status Changes the status of the specified user (for example, enabled, disabled, locked).
change user domain PUT /api/users/{UserID}/domains/{DomainID} Updates the login domain for a user, from the current login domain to a different, valid login domain.
complete signup POST /api/users/completeSignup (deprecated; use POST /api/users/completeSignup, below, instead) Deprecated. Registers the user, so that the user can log in and perform authenticated actions. As of version 8.4, this operation is replaced by POST /api/users/completeSignup (extended functionality, different headers). The pre-existing operation is supported for backwards compatibility, but it's best to use the new operation instead.
complete signup advanced POST /api/users/completeSignup Registers the user, so that the user can log in and perform authenticated actions.
delete top API DELETE /api/users/{UserID}/topapis/{APIID}

Deletes the specified API from a user's Top APIs list.

Valid in version: 2020.1.0 and later.

delete user DELETE /api/users/{userID} Deletes the specified site user.
get account settings GET /api/users/{UserID}/settings Returns the account settings of a user, including UserID, email address, and the notification events for which the user has opted to receive emails.
get APIs GET /api/users/{UserID}/apis

Returns a list of APIs for the specified user. Includes information about the APIs that the specified user is connected to; for example, as an API Administrator, API Scope Group member, or as an app team member for an app that's subscribed to the API.

Note: GET /api/users/{UserID}/apis (list APIs, with custom Accept header) returns the same information as a JSON object. We recommend using that operation rather than this one.

get apps GET /api/users/{UserID}/apps

Returns information about the apps for which the user is on the app team, with optional additional information based on query parameters. The information is returned as an RSS feed.

Note: GET /api/users/{UserID}/apps (list apps, with custom Accept header) returns the same information as a JSON object. We recommend using that operation rather than this one.

get authorization result GET /api/users/{UserID}/auzstatus?ResourceID={ResourceID} Returns information about the authorization status of the specified user in relation to the specified resource or resource type.
get avatar providers GET /api/users/{UserID}/avatarproviders Returns information about avatar providers for the specified user.
get board GET /api/users/{UserID}/board Returns a list of Board items for the specified user.
get challenges GET /api/users/{UserID}/challenges Returns information about the security challenge questions that an individual user has provided answers for.
get following GET /api/users/{UserID}/following/{ResourceID} Returns the unique ID (FollowingID) for the relationship between the specified user and the specified resource.
get followings GET /api/users/{UserID}/followings Returns information about the resources the specified user is following.
get home feed GET /api/users/{UserID}/feeds/homefeed Returns the user's feed from the user's home system.
get login domain GET /api/users/{UserID}/logindomain Returns information about the login domain for the specified user.
get my groups GET /api/users/{UserID}/groups Returns information about the groups that the specified user is a member of.
get my login domain GET /api/users/mylogindomain Returns information about the login domain for the current user.
get notifications GET /api/users/{UserID}/notifications Returns unarchived notifications for the specified user.
get notifications count GET /api/users/{UserID}/notifications/count Returns the number of current notifications for a user.
get status GET /api/users/{UserID}/status Returns a summary of statistics for the specified user, including counts for discussions, tickets, the number of users following this user (not currently used), follow requests (current or pending), and the number of APIs the user has access to.
get top APIs GET /api/users/{UserID}/topapis

Returns information about APIs that the current user has chosen to follow as Top APIs.

Valid in version: 2020.1.0 and later.

get user GET /api/users/{UserID} Returns the overview of a user.
get user preference GET /api/users/{UserID}/preferences/{PreferenceName} Returns the value of the specified user preference.
get user preferences GET /api/users/{UserID}/preferences Returns all the preferences saved for the user.
get user roles GET /api/users/{UserID}/roles?ResourceID={ResourceID} Returns the roles the user has in relation to a specified resource.
get user top APIs metrics GET /api/users/{UserID}/mydashboard Returns information about metrics for the APIs on the user's Top APIs list.
invite user to platform POST /api/users/invitations Allows a registered platform user to invite one or more additional users to join the platform. An email invitation is sent to each invited user.
list APIs GET /api/users/{UserID}/apis

Returns a list of APIs for the specified user. Includes information about the APIs that the specified user is connected to; for example, as an API Administrator, API Scope Group member, or as an app team member for an app that's subscribed to the API. The information is returned as a JSON object.

Valid in version: 2020.1.0 and later.

list apps GET /api/users/{UserID}/apps Returns information about the apps for which the user is on the app team, and optionally also information about app versions. The information is returned as a JSON object.
modify account settings PUT /api/users/{UserID}/settings Changes a user's account settings such as email notification preferences.
modify password PUT /api/users/{UserID}/password Modifies the password of a user in the system.
modify user PUT /api/users/{UserID} Modifies information about a platform user.
resend activation POST /api/users/resendActivation Resends an activation code to a user who is signing up for the platform.
save challenges PUT /api/users/{UserID}/challenges Adds or updates information about the security challenge questions and answers for a specific user.
save preferences POST /api/users/{UserID}/preferences Changes the value of a user preference.
send email change code POST /api/users/{UserID}/sendEmailChangeCode Initiates sending of email notifications to old and new email addresses when a user initiates change of email address on the account, or when a Site Admin initiates email address change for the user's account.
sign up user POST /api/users/signupUser[/{InvitationCode}] Initiates the signup process by sending the user's signup information to the database; in some cases, sends an email to the user.
validate email change code POST /api/users/validateEmailChangeCode Validates the email change code that a user provides. The code is generated, and sent to the user, in response to a request to change the email address on the account, whether initiated by the user or the Site Admin.
verify invitation POST /api/users/verifyInvitation Validates an invitation code at the signup page and returns user details.
verify signup POST /api/users/verifySignup Returns information about the signup code or where in the signup process the user is.

Back to top

Related Topics