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
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...