User Update own basic information
URL | Requires Auth | HTTP Method |
---|---|---|
/api/v1/users.updateOwnBasicInfo |
yes |
POST |
Note that to update the password or email for the user you must send currentPassword
property encrypted in SHA256 together in payload.
WARNING: This API does not work when the server contains custom fields. There’s a bug report here related to that.
Payload
Argument | Example | Required | Description |
---|---|---|---|
data.email |
example@example.com |
Optional | The email address for the user. |
data.name |
Example User |
Optional | The display name of the user. |
data.username |
example |
Optional | The username for the user. |
data.currentPassword |
5994471abb01112afcc18159f6cc74b4f511b99806da59b3caf5a9c173cacfc5@w0rd |
Optional | The password for the user encrypted in SHA256. |
data.newPassword |
passw0rd |
Optional | The new password for the user |
data.customFields |
{ twitter: '@example' } |
Optional Default: undefined |
Any custom fields the user should have on their account. |
Example Call
curl -H "X-Auth-Token: 9HqLlyZOugoStsXCUfD_0YdwnNnunAJF8V47U3QHXSq" \
-H "X-User-Id: aobEdbYhXfu5hkeqG" \
-H "Content-type:application/json" \
http://localhost:3000/api/v1/users.updateOwnBasicInfo \
-d '"data" :{"email": "pimenta.bot@pimenta.chat", "newPassword": "passw0rd",
"currentPassword": "5994471abb01112afcc18159f6cc74b4f511b99806da59b3caf5a9c173cacfc5",
"username": "pimenta.bot", name": "Example user" }'
Example Result
{
"user": {
"_id": "47cRd58HnWwpqxhaZ",
"createdAt": "2018-03-09T13:17:11.951Z",
"services": {
"password": {
"bcrypt": "$2a$10$zb/dp.AHZAhwPzgmOHcQA.5eOfu6pAYU5gchg3O74z7XzWAppJflq"
},
"email": {
"verificationTokens": [
{
"token": "rzDjTJBoN8qdc5LCVM3xqaRHEx0lR9mxkFutB6fv-YP",
"address": "pimenta.bot@pimenta.chat",
"when": "2018-03-09T13:17:11.968Z"
},
{
"token": "bFdoXbtvVl4NYXNMQn-sb6t9TWwuBYkkntakvkNqyzr",
"address": "pimenta.bot@pimenta.chat",
"when": "2018-03-09T13:18:33.414Z"
},
{
"token": "reYkTD_OfKHYgU1p6ON-UyJjvXGODl6EoZ-GLQlg81s",
"address": "pimenta.bot@pimenta.chat",
"when": "2018-03-09T14:41:21.633Z"
}
]
},
"resume": {
"loginTokens": [
{
"when": "2018-03-09T13:17:12.110Z",
"hashedToken": "T6sIP43ctqMedzVsxiF/dln27ua7l56/Rys+aq7J2JA="
},
{
"hashedToken": "0z7NG4SFO00ZvR71nNqAhK0yv/9OeGJ74WZWAUxzAwA="
}
]
}
},
"emails": [
{
"address": "pimenta.bot@pimenta.chat",
"verified": false
}
],
"type": "user",
"status": "online",
"active": true,
"name": "Example User",
"_updatedAt": "2018-03-09T20:21:08.992Z",
"roles": [
"admin",
"user",
"bot"
],
"lastLogin": "2018-03-09T20:15:20.019Z",
"statusConnection": "online",
"utcOffset": -3,
"username": "pimenta.bot",
"settings": {
"profile": {}
},
"customFields": {
"twitter": "userstwitter"
}
},
"success": true
}
Change Log
Version | Description |
---|---|
0.62.2 | Added as user.updateOwnBasicInfo |