Description
You have to call this method when you want to edit info of an existing user in DRUID.
If you edit any confirmable id (email, mobile), and mark it as not confirmed (because yo have not confirmed it externally), new id need to be confirmed. The user’s new email/mobile will not be established until the confirmation process is completed.
Please, read first https://dru-id.com/developers/apis/oauth-2/ to learn about Oauth2 protocol and the meaning of each token, and https://dru-id.com/developers/apis/oauth-2/obtain-challenge_code-token to know how to obtain the token needed to perform this operation.
Scope needed for obtain token is update.
Note that your app must have appropriate permissions to allow use of challenge code flow. Please contact with you manager to request this permissions.
Warning!: this is a replacement operation. Any data that the user already has and is not sent in the request will be removed from the user. Please check that the json is well formed before making the call to avoid possible unwanted data loss.
Endpoint URL:
POST https://{your-endpoint-domain.com}/activityid/v1/user/update
Request parameters
| Parameter | Description | Type | Required |
|---|---|---|---|
| Authorization | Bearer ${challenge_code_token}
Literal text Bearer followed by challenge_code_token that is the token obtained from /oauth2/token endpoint | string | yes |
| Content-Type | application/son | string | yes |
| Accept | application/son | 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 |
|---|---|---|---|
| code_verifier | The code verifier for the PKCE request, that the app originally generated before the authorization request, as defined in https://dru-id.com/developers/apis/oauth-2/obtain-challenge_code-token | string | yes |
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.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: user updated successfully, and email or mobile needs confirmation
Response: no changes in update
You will receive Http Response 304 Not Modified