API Documentation
API Documentation
  • Overview
  • Terms & Guidelines
  • Rest API v1
    • Authentication
      • Obtain access token
      • Make authorized calls
    • Collections
      • Collection methods
      • Nested structure
      • Sharing
      • Covers/icons
    • Raindrops
      • Single raindrop
      • Multiple raindrops
    • Highlights
    • User
      • Authenticated user
    • Tags
    • Filters
    • Import
    • Export
    • Backups
  • More
    • Changelog
    • Showcase
Powered by GitBook
On this page
  • Get tags
  • Rename tag
  • Merge tags
  • Remove tag(s)

Was this helpful?

  1. Rest API v1

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

{
    "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)

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

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

{
    "result": true
}
PreviousAuthenticated userNextFilters

Last updated 2 years ago

Was this helpful?