Users (1.0)
Download OpenAPI specification:Download
API to manage users identity and access management. It brings together the management and modification of users, groups and roles.
Get item
Retrieved one user from a customer
Authorizations:
path Parameters
id required | string |
Responses
Response samples
- 200
- 401
- 403
- 404
- 500
{- "id": "string",
- "customerId": "string",
- "createDate": "2019-08-24T14:15:22Z",
- "updateDate": "2019-08-24T14:15:22Z",
- "modelVersion": "string",
- "dbVersion": 0,
- "lastUpdateReason": "string",
- "email": "string",
- "firstName": "string",
- "lastName": "string",
- "locale": "string",
- "inactive": true,
- "token": "string",
- "userName": "string",
- "password": "string",
- "clientId": "string",
- "secretKeys": [
- {
- "id": "string"
}
], - "roleIds": [
- "string"
], - "metaRoleIds": [
- "string"
], - "authorizedCustomerIds": [
- "string"
], - "emails": [
- {
- "id": "string",
- "emailId": "string",
- "createDate": "2019-08-24T14:15:22Z",
- "type": "string",
- "error": "string"
}
], - "preferences": {
- "property1": { },
- "property2": { }
}, - "provider": {
- "property1": {
- "id": "string"
}, - "property2": {
- "id": "string"
}
}
}
Update a user
Update a user from a customer.
Authorizations:
path Parameters
id required | string |
Request Body schema: application/jsonrequired
customerId | string |
email required | string [ 6 .. 150 ] characters |
firstName required | string [ 1 .. 50 ] characters First name |
lastName required | string [ 1 .. 50 ] characters Last name |
userName required | string [ 1 .. 50 ] characters Name |
status required | string Enum: "ENABLED" "DISABLED" Status |
authorizedCustomerIds | Array of strings unique Customer Identifiers this user has rights on |
Responses
Request samples
- Payload
{- "customerId": "string",
- "email": "string",
- "firstName": "string",
- "lastName": "string",
- "userName": "string",
- "status": "ENABLED",
- "authorizedCustomerIds": [
- "string"
]
}
Get items
Retrieved all users from a customer.
Authorizations:
query Parameters
required | object (Pageable) |
predicate required | object |
target | string Return selected fields only (multiple occurrences allowed for selecting multiple fields) |
Responses
Response samples
- 200
- 401
- 403
- 404
- 500
{- "items": [
- {
- "id": "string",
- "customerId": "string",
- "createDate": "2019-08-24T14:15:22Z",
- "updateDate": "2019-08-24T14:15:22Z",
- "modelVersion": "string",
- "dbVersion": 0,
- "lastUpdateReason": "string",
- "email": "string",
- "firstName": "string",
- "lastName": "string",
- "locale": "string",
- "inactive": true,
- "token": "string",
- "userName": "string",
- "password": "string",
- "clientId": "string",
- "secretKeys": [
- {
- "id": "string"
}
], - "roleIds": [
- "string"
], - "metaRoleIds": [
- "string"
], - "authorizedCustomerIds": [
- "string"
], - "emails": [
- {
- "id": "string",
- "emailId": "string",
- "createDate": "2019-08-24T14:15:22Z",
- "type": "string",
- "error": "string"
}
], - "preferences": {
- "property1": { },
- "property2": { }
}, - "provider": {
- "property1": {
- "id": "string"
}, - "property2": {
- "id": "string"
}
}
}
], - "last": true,
- "totalItems": 0,
- "totalPages": 0,
- "size": 0,
- "number": 0
}
Create a user
Create a user from a customer.
Authorizations:
Request Body schema: application/jsonrequired
id | string Deprecated |
customerId | string |
createDate | string <date-time> Deprecated |
updateDate | string <date-time> Deprecated |
modelVersion | string Deprecated |
dbVersion | integer <int64> |
lastUpdateReason | string |
originalId | string |
status required | string Enum: "ENABLED" "DISABLED" Status |
email required | string [ 6 .. 150 ] characters |
firstName required | string [ 1 .. 50 ] characters First name |
lastName required | string [ 1 .. 50 ] characters Last name |
userName required | string [ 1 .. 50 ] characters Name |
password required | string [ 8 .. 50 ] characters Password |
token | string Token used for reset the password |
Array of objects (Email) List of emails sent to the user | |
Array of objects (AuthorizedCustomer) List of authorized customer | |
object Preferences | |
authorizedCustomerIds | Array of strings unique |
Responses
Request samples
- Payload
{- "id": "string",
- "customerId": "string",
- "createDate": "2019-08-24T14:15:22Z",
- "updateDate": "2019-08-24T14:15:22Z",
- "modelVersion": "string",
- "dbVersion": 0,
- "lastUpdateReason": "string",
- "originalId": "string",
- "status": "ENABLED",
- "email": "string",
- "firstName": "string",
- "lastName": "string",
- "userName": "string",
- "password": "stringst",
- "token": "string",
- "emails": [
- { }
], - "authorizedCustomers": [
- {
- "customerId": "string",
- "name": "string"
}
], - "preferences": {
- "property1": { },
- "property2": { }
}, - "authorizedCustomerIds": [
- "string"
]
}
Response samples
- 201
- 401
- 403
- 404
- 500
{ }
Get recap quantities for a given field
Get a list of recap entries
Authorizations:
query Parameters
target required | string Return selected fields only (multiple occurrences allowed for selecting multiple fields) |
required | object (Pageable) |
predicate required | object |
Responses
Response samples
- 200
- 401
- 403
- 404
- 500
{- "items": [
- {
- "targetValue": "string",
- "count": 0
}
], - "last": true,
- "totalItems": 0,
- "totalPages": 0,
- "size": 0,
- "number": 0
}
Reset a password
Reset a password from a user.
Authorizations:
path Parameters
realm required | string |
token required | string |
Request Body schema: application/jsonrequired
password required | string Password related to a user. |
Responses
Request samples
- Payload
{- "password": "string"
}
Trigger the lost password actions
Trigger the lost password actions.
Authorizations:
path Parameters
realm required | string |
Request Body schema: application/jsonrequired
email required | string [ 6 .. 150 ] characters User email |
Responses
Request samples
- Payload
{- "email": "string"
}