Authenticated user

get
Get user

https://api.raindrop.io/rest/v1/user
Get currently authenticated user details
Request
Response
Request
Response
200: OK
{
"result": true,
"user": {
"_id": 32,
"config": {
"broken_level": "strict",
"font_color": "",
"font_size": 0,
"lang": "ru_RU",
"last_collection": 8492393,
"raindrops_sort": "-lastUpdate",
"raindrops_view": "list"
},
"dropbox": {
"enabled": true
},
"email": "some@email.com",
"email_MD5": "13a0a20681d8781912e5314150694bf7",
"files": {
"used": 6766094,
"size": 10000000000,
"lastCheckPoint": "2020-01-26T23:53:19.676Z"
},
"fullName": "Mussabekov Rustem",
"gdrive": {
"enabled": true
},
"groups": [
{
"title": "My Collections",
"hidden": false,
"sort": 0,
"collections": [
8364483,
8364403,
66
]
}
],
"password": true,
"pro": true,
"proExpire": "2028-09-27T22:00:00.000Z",
"registered": "2014-09-30T07:51:15.406Z"
}
}
401: Unauthorized
Unauthorized

get
Get user by ID

https://api.raindrop.io/rest/v1/user/{id}
Get's publicly available user details
Request
Response
Request
Path Parameters
id
required
number
User ID
Response
200: OK
{
"result": true,
"user": {
"_id": 32,
"email_MD5": "13a0a20681d8781912e5314150694bf7",
"fullName": "Mussabekov Rustem",
"pro": true,
"registered": "2014-09-30T07:51:15.406Z"
}
}
404: Not Found
{
"error": -1,
"errorMessage": "not found",
"result": false
}

put
Update user

https://api.raindrop.io/rest/v1/user
To change email, config, password, etc... you can do it from single endpoint
Request
Response
Request
Body Parameters
groups
optional
array
config
optional
object
newpassword
optional
string
oldpassword
optional
string
fullName
optional
string
email
optional
string
Response
200: OK
{
"result": true,
"user": {
...
}
}
400: Bad Request
//email specified but empty
{
"result": false,
"error": 1,
"errorMessage": "email required"
}
//fullName specified but empty
{
"result": false,
"error": 2,
"errorMessage": "User validation failed: fullName: is required"
}
//newpassword specified, but oldpassword is empty
{
"result": false,
"error": 3,
"errorMessage": "oldpassword incorrect"
}
//incorrect config key value
{
"result": false,
"error": "config.raindrops_sort",
"errorMessage": "User validation failed: config.raindrops_sort: `1` is not a valid enum value for path `raindrops_sort`., config: Validation failed: raindrops_sort: `1` is not a valid enum value for path `raindrops_sort`."
}

get
Connect social network account

https://api.raindrop.io/rest/v1/user/connect/{provider}
Connect social network account as sign in authentication option
Request
Response
Request
Path Parameters
provider
optional
string
facebook google twitter vkontakte dropbox or gdrive
Response
307: Temporary Redirect
Location: https://some.com/...

get
Disconnect social network account

https://api.raindrop.io/rest/v1/user/connect/{provider}/revoke
Disconnect social network account from available authentication options
Request
Response
Request
Path Parameters
provider
optional
string
facebook google twitter vkontakte dropbox or gdrive
Response
200: OK