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": "[email protected]",
      "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
​
Rest API v1 - Previous
User
Next - Rest API v1
Authenticated user

getGet user

getGet user by ID

putUpdate user

getConnect social network account

getDisconnect social network account

get
Get user

get
Get user by ID

put
Update user

get
Connect social network account

get
Disconnect social network account
