/user

Search Users

get

Searches all users in the system and returning the metadata for all matches against the given search filter.

Authorizations
Query parameters
offsetanyOptionalDefault: 0
countanyOptionalDefault: 20
searchanyOptional
Responses
400Error
application/json
get
GET /api/rest/user HTTP/1.1
Host: localhost:8080
Authorization: YOUR_API_KEY
Accept: */*
{
  "code": "text",
  "message": "text"
}

Creates a User

post

Supplying the user object, this will update the user with the new information supplied in the body of the request. Optionally, the user's password may be provided in the User object.

Authorizations
Body
nameanyOptionalPattern: ^\S+$
emailanyOptionalPattern: ^(.+)@(.+)$
primaryPhoneNbanyOptionalPattern: ([\.\+\-\s\/()]*[0-9][\.\+\-\s\/()]*){8,15}
firstNameanyOptionalPattern: ^[A-Za-z0-9 ]{2,20}
lastNameanyOptionalPattern: ^[A-Za-z0-9 ]{3,30}
passwordanyOptional

The user's plaintext password, only to be provided in POST/PUT requests in the User Resource REST API interface. In the future, a dedicated REST API model may be constructed instead of using a direct User model.

Pattern: ^\S+$
levelundefined · enumOptional

The user's level to assign. Depending on the usage, the server may ignore this field and assign its own description.

Possible values:
profilesanyOptional

A list of profiles to assign to this user during creation. The server will attempt to create a profile for each item in this list.

Responses
400Error
application/json
post
POST /api/rest/user HTTP/1.1
Host: localhost:8080
Authorization: YOUR_API_KEY
Content-Type: */*
Accept: */*
Content-Length: 191

{
  "name": null,
  "email": null,
  "primaryPhoneNb": null,
  "firstName": null,
  "lastName": null,
  "password": null,
  "level": "UNPRIVILEGED",
  "profiles": [
    {
      "applicationId": null,
      "displayName": null,
      "imageUrl": null
    }
  ]
}
{
  "code": "text",
  "message": "text"
}

Gets a Specific User

get

Gets a specific user by email or unique user ID.

Authorizations
Path parameters
nameanyRequired
Responses
400Error
application/json
get
GET /api/rest/user/{name} HTTP/1.1
Host: localhost:8080
Authorization: YOUR_API_KEY
Accept: */*
{
  "code": "text",
  "message": "text"
}

Deletes a User

delete

Deletes and permanently removes the user from the server. The server may keep some metadata as necessary to avoid data inconsistency. However, the user has been deleted from the client standpoint and will not be accessible through any of the existing APIs.

Authorizations
Path parameters
nameanyRequired
Responses
400Error
application/json
delete
DELETE /api/rest/user/{name} HTTP/1.1
Host: localhost:8080
Authorization: YOUR_API_KEY
Accept: */*
{
  "code": "text",
  "message": "text"
}

Updates a User's Password

put

Supplying the UserUpdatePasswordRequest, this will attempt to update the user's password only if they supply the correct existing password.

Authorizations
Path parameters
userIdanyRequired
Body
oldPasswordanyRequired

The user's current password.

newPasswordanyRequired

The user's updated password.

profileIdanyOptional

The user's profile id to assign the new session. Leave blank for no profile id.

Responses
400Error
application/json
put
PUT /api/rest/user/{userId}/password HTTP/1.1
Host: localhost:8080
Authorization: YOUR_API_KEY
Content-Type: */*
Accept: */*
Content-Length: 56

{
  "oldPassword": null,
  "newPassword": null,
  "profileId": null
}
{
  "code": "text",
  "message": "text"
}

Updates a User

put

Supplying the user object, this will update the user with the new information supplied in the body of the request. Optionally, the user's password may be provided in the User object.

Authorizations
Path parameters
userIdanyRequired
Body
nameanyRequiredPattern: ^\S+$
emailanyRequiredPattern: ^(.+)@(.+)$
primaryPhoneNbanyOptionalPattern: ([\.\+\-\s\/()]*[0-9][\.\+\-\s\/()]*){8,15}
firstNameanyOptionalPattern: ^[A-Za-z0-9 ]{2,20}
lastNameanyOptionalPattern: ^[A-Za-z0-9 ]{3,30}
passwordanyOptional

The user's plaintext password, only to be provided in POST/PUT requests in the User Resource REST API interface. In the future, a dedicated REST API model may be constructed instead of using a direct User model.

Pattern: ^\S+$
levelundefined · enumRequiredPossible values:
Responses
400Error
application/json
put
PUT /api/rest/user/{userId} HTTP/1.1
Host: localhost:8080
Authorization: YOUR_API_KEY
Content-Type: */*
Accept: */*
Content-Length: 120

{
  "name": null,
  "email": null,
  "primaryPhoneNb": null,
  "firstName": null,
  "lastName": null,
  "password": null,
  "level": "UNPRIVILEGED"
}
{
  "code": "text",
  "message": "text"
}

Gets the current User

get

A special endpoint used to get the current user for the request. The current user is typically associated with the session but may be derived any other way. This is essentially an alias for using GET /user/myUserId

Authorizations
Responses
400Error
application/json
get
GET /api/rest/user/me HTTP/1.1
Host: localhost:8080
Authorization: YOUR_API_KEY
Accept: */*
{
  "code": "text",
  "message": "text"
}

Last updated