Single raindrop

get
Get raindrop
https://api.raindrop.io/rest/v1/raindrop/{id}
Request
Response
Request
Path Parameters
id
required
number
Existing raindrop ID
Response
200: OK
​
post
Create raindrop
https://api.raindrop.io/rest/v1/raindrop
Description and possible values of fields described in "Fields"
Request
Response
Request
Body Parameters
pleaseParse
optional
object
Specify empty object to automatically parse meta data (cover, description, html) in the background
created
optional
string
​
lastUpdate
optional
string
​
order
optional
number
Specify sort order (ascending).
For example if you want to move raindrop to the first place set this field to 0
important
optional
boolean
​
tags
optional
array
​
media
optional
array
​
cover
optional
string
​
collection
optional
object
​
type
optional
string
​
html
optional
string
​
excerpt
optional
string
​
title
optional
string
​
link
required
string
​
Response
200: OK
{
    "result": true,
    "item": {
        ...
    }
}
put
Update raindrop
https://api.raindrop.io/rest/v1/raindrop/{id}
Description and possible values of fields described in "Fields"
Request
Response
Request
Path Parameters
id
required
number
Existing raindrop ID
Body Parameters
created
optional
string
​
lastUpdate
optional
string
​
pleaseParse
optional
object
Specify empty object to re-parse link meta data (cover, type, html) in the background
order
optional
number
Specify sort order (ascending).
For example if you want to move raindrop to the first place set this field to 0
important
optional
boolean
​
tags
optional
array
​
media
optional
array
​
cover
optional
string
​
collection
optional
object
​
type
optional
string
​
html
optional
string
​
excerpt
optional
string
​
title
optional
string
​
link
optional
string
​
Response
200: OK
{
    "result": true,
    "item": {
        ...
    }
}
post
​
https://api.raindrop.io/rest/v1/raindrop
Request
Response
Request
Body Parameters
pleaseParse
optional
object
empty
Response
200: OK
​
delete
Remove raindrop
https://api.raindrop.io/rest/v1/raindrop/{id}
When you remove raindrop it will be moved to user Trash collection. But if you try to remove raindrop from Trash, it will be removed permanently.
Request
Response
Request
Path Parameters
id
required
number
Existing raindrop ID
Response
200: OK
{
    "result": true
}
put
Upload file
https://api.raindrop.io/rest/v1/raindrop/{id}/file
To upload file you need to create single raindrop with any details, and then call this method for this raindrop. Sorry, will be simplified in the future.
Request
Response
Request
Path Parameters
id
required
number
Existing raindrop ID
Headers
Content-Type
required
string
multipart/form-data
Form Data Parameters
file
required
object
File
Response
200: OK
{
    "result": true,
    "item": {
        "title": "File name",
        "type": "image",
        "link": "https://up.raindrop.io/raindrop/111/file.jpeg",
        "domain": "raindrop.io",
        "file": {
            "name": "File name.jpeg",
            "size": 10000
        }
        ...
    }
}
400: Bad Request
//file is not specified
{
  "result": false,
  "error": -1,
  "errorMessage": "no file"
}
​
//unsupported file format
{
  "result": false,
  "error": "file_invalid",
  "errorMessage": "File is invalid"
}
​
//file size is big
{
  "result": false,
  "error": "file_size_limit",
  "errorMessage": "File size limit"
}
put
Upload cover
https://api.raindrop.io/rest/v1/raindrop/{id}/cover
PNG, GIF or JPEG
Request
Response
Request
Path Parameters
id
required
number
Existing raindrop ID
Headers
Content-Type
required
string
multipart/form-data
Form Data Parameters
cover
required
object
File
Response
200: OK
{
    "result": true,
    "item": {
        "cover": "https://up.raindrop.io/raindrop/...",
        "media": [
            {
                "link": "https://up.raindrop.io/raindrop/..."
            }
        ]
        ...
    }
}
400: Bad Request
//file is not specified
{
  "result": false,
  "error": -1,
  "errorMessage": "no file"
}
​
//unsupported file format
{
  "result": false,
  "error": "file_invalid",
  "errorMessage": "File is invalid"
}
​
//file size is big
{
  "result": false,
  "error": "file_size_limit",
  "errorMessage": "File size limit"
}
get
Get permanent copy
https://api.raindrop.io/rest/v1/raindrop/{id}/cache
Links permanently saved with all content (only in PRO plan). Using this method you can navigate to this copy.
Request
Response
Request
Path Parameters
id
required
number
Existing raindrop ID
Response
307: Temporary Redirect
Location: https://s3.aws...