Single raindrop

In this page you will find how to retrieve, create, update or delete single raindrop.

PreviousRaindrops NextMultiple raindrops

Last updated 7 months ago

Get raindrop

GET https://api.raindrop.io/rest/v1/raindrop/{id}

Path Parameters

Name

Type

Description

Create raindrop

POST https://api.raindrop.io/rest/v1/raindrop

Description and possible values of fields described in "Fields"

Request Body

Name

Type

Description

{
    "result": true,
    "item": {
        ...
    }
}

Update raindrop

PUT https://api.raindrop.io/rest/v1/raindrop/{id}

Description and possible values of fields described in "Fields"

Path Parameters

Request Body

{
    "result": true,
    "item": {
        ...
    }
}

Remove raindrop

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

Path Parameters

{
    "result": true
}

Upload file

PUT https://api.raindrop.io/rest/v1/raindrop/file

Make sure to send PUT request with multipart/form-data body

Headers

Request Body

{
    "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
        }
        ...
    }
}

//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"
}

Upload cover

PUT https://api.raindrop.io/rest/v1/raindrop/{id}/cover

PNG, GIF or JPEG

Path Parameters

Headers

Request Body

{
    "result": true,
    "item": {
        "cover": "https://up.raindrop.io/raindrop/...",
        "media": [
            {
                "link": "https://up.raindrop.io/raindrop/..."
            }
        ]
        ...
    }
}

//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 permanent copy

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

Path Parameters

Location: https://s3.aws...

Suggest collection and tags for new bookmark

POST https://api.raindrop.io/rest/v1/raindrop/suggest

Request Body

{
    "result": true,
    "item": {
        "collections": [
            {
                "$id": 568368
            },
            {
                "$id": 8519567
            },
            {
                "$id": 1385626
            },
            {
                "$id": 8379661
            },
            {
                "$id": 20865985
            }
        ],
        "tags": [
            "fonts",
            "free",
            "engineering",
            "icons",
            "invalid_parser"
        ]
    }
}

Suggest collection and tags for existing bookmark

GET https://api.raindrop.io/rest/v1/raindrop/{id}/suggest

Path Parameters

{
    "result": true,
    "item": {
        "collections": [
            {
                "$id": 568368
            },
            {
                "$id": 8519567
            },
            {
                "$id": 1385626
            },
            {
                "$id": 8379661
            },
            {
                "$id": 20865985
            }
        ],
        "tags": [
            "fonts",
            "free",
            "engineering",
            "icons",
            "invalid_parser"
        ]
    }
}