Description
You have to call this method when you want to update password of a logged user in DRUID.
Please, read first https://dru-id.com/developers/apis/oauth-2/ to learn about Oauth2 protocol and the meaning of each token.
Endpoint URL:
POST https://{your-endpoint-domain.com}/activityid/v1/password/update
Request parameters
| Parameter | Description | Type | Required |
|---|---|---|---|
| Authorization | Bearer ${access_token}
Literal text Bearer followed by access_token that is the token for current logged user obtained from login endpoint | string | yes |
| Content-Type | application/json | string | yes |
| Accept | application/json | string | yes |
| From | Id of the entry point | string | yes |
| Accept-Language | Language of this request | Locale | no |
Query string parameters
| Parameter | Description | Type | Required |
|---|
Request example
| Parameter | Description | Type | Required | Value |
|---|---|---|---|---|
| actor.id | app_id of the application you are using to log user | string | yes | app id |
| actor.objectType | Type of the object which represents the actor. | string | yes | ‘application’ |
| verb | Verb used for create user | string | yes | ‘create’ |
| object.objectType | ObjectType represents the user | string | yes | ‘user’ |
| object.password | Password of the user. it must be send plain | string | yes | user password |
| object.ids | User identifiers. More info about user identifiers User Info | struct | yes | struct |
| object.datas | User datas. More info about user datas User Info | struct | yes | struct |
| object.addresses | User addresses. More info about user addresses User Info | struct | no | struct |
| object.assertions | Struct that defines legalities manage by the user. More info about user assertions User Info | struct | yes | struct |
| source.id | Type of device doing the activity | string | yes | ‘unknown’ | ‘pc’ | ‘mobile’ | ‘tablet’ | ‘game_console’ | ‘itv’ |
| source.objectType | Type of source | string | yes | ‘device’ |
Response examples
Response: user updated successfully
Response codes
| Code | Type | Description |
|---|---|---|
| 200 | Success | Password updated successfully. |
| 400 | Error | Bad Request: The request could not be understood by the server due to malformed syntax |
| 401 | Error | Unauthorized: authentication is required and has failed or has not yet been provided (token is invalid, etc) |
| 403 | Error | Forbidden: user id or password are invalid |
| 416 | Error | The password do not comply with the password policy |
| 428 | Error | Precondition required: User need to configure MFA or needs to send a MFA code. Check the MFA API |
| 500 | Error | Internal Server Error: The server encountered an unexpected condition which prevented it from fulfilling the request |