Tags

Get tags

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

Path Parameters

Name	Type	Description
collectionId	number	Optional collection ID, when not specified all tags from all collections will be retrieved

200

{
    "result": true,
    "items": [
        {
            "_id": "api",
            "count": 100
        }
    ]
}

Rename tag

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

Path Parameters

Name	Type	Description
collectionId	number	It's possible to restrict rename action to just one collection. It's optional

Request Body

Name	Type	Description
replace	string	New name
tags	array	Specify array with only one string (name of a tag)

200

{
    "result": true
}

Merge tags

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

Basically this action rename bunch of

tags

to new name (

replace

field)

Path Parameters

Name	Type	Description
collectionId	string	It's possible to restrict merge action to just one collection. It's optional

Request Body

Name	Type	Description
replace	string	New name
tags	array	List of tags

200

{
    "result": true
}

Remove tag(s)

DELETE https://api.raindrop.io/rest/v1/tags/{collectionId}

Path Parameters

Name	Type	Description
collectionId	string	It's possible to restrict remove action to just one collection. It's optional

Request Body

Name	Type	Description
tags	array	List of tags

200

{
    "result": true
}

Suggest tags

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

Path Parameters

Name	Type	Description
raindropId	number	Raindrop ID

200

{
    "result": true,
    "tags": [
        "app",
        "development"
    ]
}