Skip to main content
Version: v5.0

User

Add a User#

Endpoint#

POST /passportsvc/api/v1/accounts

Parameters#

Body#

Pass a User class object. Please set the optional _tempPassword to true to consider _password as temporary and enforce the user to reset the password on their first login.

{  "_firstname": "john",  "_lastname": "doe",  "_email": "[email protected]",  "_password": "Password@1",  "_tempPassword": true}

Response#

Codes#

CodeDescription
200Success

Response data example#

{  "_id": "ab50463c-074f-4bbb-905b-c1a7e1fbdfcf",  "_firstName": "john",  "_lastName": "doe",  "_email": "[email protected]",  "_eusa": false,  "_privacy": false}

Find all Users#

Endpoint#

GET /passportsvc/api/v1/users

Request#

Body parameters#

ParameterTypeDescriptionRequired
queryStringEnter text to search fields such as the _firstName, _lastName or _email properties. The users are ordered by _firstName in the response.Optional
Body parameters examples#

Response#

{  "_offset": 0,  "_pageSize": 2,  "_total": 2,  "_list": [    {      "_id": "77cb6211-b9a2-4313-9aa7-4d15209203c7",      "_firstname": "john",      "_lastname": "doe",      "_eusa": false,      "_privacy": true,      "_disabled": false    },    {      "_id": "646467e6-53c1-4775-b4bf-6fc937e62935",      "_firstname": "James",      "_lastname": "Anderson",      "_eusa": false,      "_privacy": true,      "_disabled": false    }  ]}

Get Me#

Gets the current user

Endpoint#

GET /passportsvc/api/v1/users/me

Response data#

{  "_id": "bb96242e-9977-4fb6-9bc2-7f56b11cdeda",  "_firstname": "John",  "_lastname": "d",  "_eusa": false,  "_privacy": false,  "_email": "[email protected]",  "_disabled": false}

Update User#

Endpoint#

PUT /passportsvc/api/v1/users/{id}

Request#

Query parameters#

ParameterTypeDescriptionRequired
_idStringThe user's idOptional

Body parameters#

ParameterTypeDescriptionRequired
_firstnameStringEdit the user's first name.Optional
_lastnameStringEdit the user's last name.Optional
_disabledBooleanEnable or disable the user.Optional
Body parameter example#
{  "_firstname" : "John",  "_lastname" : "d",  "_disabled": true}

Response#

Response data example#

{  "_id": "bb96242e-9977-4fb6-9bc2-7f56b11cdeda",  "_firstname": "John",  "_lastname": "d",  "_eusa": false,  "_privacy": false,  "_email": "[email protected]",  "_disabled": false}

Enable/Disable User#

Endpoint#

PUT /passportsvc/api/v1/users/{id}/disabled

Request#

Path parameters#

ParameterTypeDescriptionRequired
_idStringThe user's idOptional

Body#

// disables the usertrue
// enables the userfalse

Response#

{  "_id": "bb96242e-9977-4fb6-9bc2-7f56b11cdeda",  "_firstname": "John",  "_lastname": "d",  "_eusa": false,  "_privacy": false,  "_email": "[email protected]",  "_disabled": false}

Get User by Id#

Endpoint#

GET /passportsvc/api/v1/users/{id}

Request#

Path parameters#

ParameterTypeDescriptionRequired
_idStringThe user's idOptional

Response#

Response data example#

{  "_id": "bb96242e-9977-4fb6-9bc2-7f56b11cdeda",  "_firstname": "John",  "_lastname": "d",  "_eusa": false,  "_privacy": false,  "_disabled": false}