Application Users Controller Resource

The API allows you to list, view, edit and create application users.

GET /users

Return list of users.

Request Parameters
name type description constraints
active query boolean
direction query  
filter query  
groups query  
nameLike query  
orderBy query  
page query  
size query  
Response Body
media type data type description
application/json array of AppUserListRecord (JSON) list of users

Example

Request
GET /users
Content-Type: */*
Accept: application/json

                
...
                
              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "login" : "...",
  "firstName" : "...",
  "lastName" : "...",
  "groups" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "active" : true,
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
} ]
                
              

POST /users

Create a new user.

Request Body
media type data type description
application/json NewUserRequest (JSON) specify data for new user
Response Body
media type data type description
application/json AppUserDetails (JSON) details of newly created user

Example

Request
POST /users
Content-Type: application/json
Accept: application/json

                
{
  "login" : "...",
  "password" : "...",
  "firstName" : "...",
  "lastName" : "...",
  "thirdPartyRestriction" : "NO_RESTRICTION",
  "language" : "CN",
  "active" : true,
  "infoTourEnabled" : true,
  "groups" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "appUserSettings" : {
    "pageSize" : 12345,
    "timeFormat" : "..."
  },
  "uiTimeZone" : "UTC"
}
                
              
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{
  "login" : "...",
  "firstName" : "...",
  "lastName" : "...",
  "lastFailedLoginIp" : "...",
  "source" : "KEYCLOAK",
  "language" : "DE",
  "active" : true,
  "infoTourEnabled" : true,
  "endpointsOrganization" : {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  },
  "groups" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "appUserSettings" : {
    "pageSize" : 12345,
    "timeFormat" : 12345
  },
  "externalId" : "...",
  "thirdPartyRestriction" : "NO_RESTRICTION",
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "lastSuccessfulLogin" : 1451649601000,
  "lastFailedLogin" : 1451677502000,
  "uiTimeZone" : "UTC"
}
                
              

PUT /users/active

Change active state for specified list of users.

Request Body
media type data type description
application/json SingleAttributeBatchUpdate (JSON) specify active state and guids of users
Response Body
media type data type description
application/json BatchResponse (JSON) list of successful and unsuccessful updates of active state

Example

Request
PUT /users/active
Content-Type: application/json
Accept: application/json

                
{
  "value" : "...",
  "entities" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ]
}
                
              
Response
HTTP/1.1 204 No Content
Content-Type: application/json

                
{
  "successful" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "unsuccessful" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ]
}
                
              

GET /users/third-party-restrictions

Return list of all possible third party restrictions.

Response Body
media type data type description
application/json array of ThirdPartyRestriction (JSON) list of all possible third party restrictions

Example

Request
GET /users/third-party-restrictions
Content-Type: */*
Accept: application/json

                
...
                
              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
"NO_RESTRICTION"
                
              

DELETE /users/{guid}

Remove user.

Request Parameters
name type description
guid path specify local unique identifier for user (use by vProtect)

Example

Request
DELETE /users/{guid}
Content-Type: */*

                
...
                
              
Response
HTTP/1.1 204 No Content

              

GET /users/{guid}

Get a single user.

Request Parameters
name type description
guid path specify local unique identifier for user (use by vProtect)
Response Body
media type data type description
application/json AppUserDetails (JSON) a single user details

Example

Request
GET /users/{guid}
Content-Type: */*
Accept: application/json

                
...
                
              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "login" : "...",
  "firstName" : "...",
  "lastName" : "...",
  "lastFailedLoginIp" : "...",
  "source" : "LOCAL",
  "language" : "JA",
  "active" : true,
  "infoTourEnabled" : true,
  "endpointsOrganization" : {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  },
  "groups" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "appUserSettings" : {
    "pageSize" : 12345,
    "timeFormat" : 12345
  },
  "externalId" : "...",
  "thirdPartyRestriction" : "NO_RESTRICTION",
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "lastSuccessfulLogin" : 1451649601000,
  "lastFailedLogin" : 1451677502000,
  "uiTimeZone" : "UTC"
}
                
              

PUT /users/{guid}

Change user details.

Request Parameters
name type description
guid path specify local unique identifier for user (use by vProtect)
Request Body
media type data type description
application/json UpdateUserRequest (JSON) specify user details to update
Response Body
media type data type description
application/json AppUserDetails (JSON) updated details of user

Example

Request
PUT /users/{guid}
Content-Type: application/json
Accept: application/json

                
{
  "login" : "...",
  "firstName" : "...",
  "lastName" : "...",
  "language" : "FR",
  "active" : true,
  "infoTourEnabled" : true,
  "externalId" : "...",
  "thirdPartyRestriction" : "NO_RESTRICTION",
  "appUserSettings" : {
    "pageSize" : 12345,
    "timeFormat" : "..."
  },
  "uiTimeZone" : "UTC",
  "groups" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ]
}
                
              
Response
HTTP/1.1 204 No Content
Content-Type: application/json

                
{
  "login" : "...",
  "firstName" : "...",
  "lastName" : "...",
  "lastFailedLoginIp" : "...",
  "source" : "LOCAL",
  "language" : "CN",
  "active" : true,
  "infoTourEnabled" : true,
  "endpointsOrganization" : {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  },
  "groups" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "appUserSettings" : {
    "pageSize" : 12345,
    "timeFormat" : 12345
  },
  "externalId" : "...",
  "thirdPartyRestriction" : "HORIZON",
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "lastSuccessfulLogin" : 1451649601000,
  "lastFailedLogin" : 1451677502000,
  "uiTimeZone" : "UTC"
}
                
              

PUT /users/{guid}/endpoints-organization

Change user Endpoints Organization.

Request Parameters
name type description
guid path specify local unique identifier for user (use by vProtect)
Request Body
media type data type
application/json NameAndGuid (JSON)

Example

Request
PUT /users/{guid}/endpoints-organization
Content-Type: application/json

                
{
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "name" : "Entity name"
}
                
              
Response
HTTP/1.1 204 No Content

              

GET /users/{guid}/groups

Get a list of user groups.

Request Parameters
name type description
guid path specify local unique identifier for user (use by vProtect)
Response Body
media type data type description
application/json array of AppUserGroupListRecord (JSON) a single user details

Example

Request
GET /users/{guid}/groups
Content-Type: */*
Accept: application/json

                
...
                
              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "guid" : "...",
  "name" : "...",
  "description" : "...",
  "deletable" : true,
  "defaultLdapGroup" : true,
  "defaultKeycloakGroup" : true
} ]
                
              

PUT /users/{guid}/info-tour

Set user info tour enablement

Request Parameters
name type description
guid path local unique identifier for user (use by vProtect)
Request Body
media type data type
application/json BooleanDTO (JSON)

Example

Request
PUT /users/{guid}/info-tour
Content-Type: application/json

                
{
  "value" : true
}
                
              
Response
HTTP/1.1 204 No Content

              

PUT /users/{guid}/password

Change user password.

Request Parameters
name type description
guid path specify local unique identifier for user (use by vProtect)
Request Body
media type data type description
application/json StringDTO (JSON) specify user password

Example

Request
PUT /users/{guid}/password
Content-Type: application/json

                
{
  "value" : "..."
}
                
              
Response
HTTP/1.1 204 No Content

              

GET /users/{guid}/settings

Get user personal settings

Request Parameters
name type description
guid path local unique identifier for user (use by vProtect)
Response Body
media type data type description
application/json AppUserSettingsDetails (JSON)

Example

Request
GET /users/{guid}/settings
Content-Type: application/json
Accept: application/json

                
...
                
              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "pageSize" : 12345,
  "timeFormat" : 12345
}
                
              

PUT /users/{guid}/settings

Set user personal settings

Request Parameters
name type description
guid path local unique identifier for user (use by vProtect)
Request Body
media type data type description
application/json AppUserSettingsRequest (JSON) user settings request
Response Body
media type data type description
application/json AppUserSettingsDetails (JSON)

Example

Request
PUT /users/{guid}/settings
Content-Type: application/json
Accept: application/json

                
{
  "pageSize" : 12345,
  "timeFormat" : "..."
}
                
              
Response
HTTP/1.1 204 No Content
Content-Type: application/json

                
{
  "pageSize" : 12345,
  "timeFormat" : 12345
}