For Agents
Programmatically get root collections, reorder all collections. Covers 48 operations with bearer, oauth2 authentication.
Use for: I need to root collections, I want to reorder all collections, Search for remove multiple collections, Find all child collections
Not supported: Does not handle payments, communications, or crm — use for storage and databases only.
**UNOFFICIAL** OpenAPI specification of Raindrop API. This OpenAPI spec has been made by hand with reference to official documentation because it is not provided by Raindrop.io. Because official documentation not maintained well, there are very (highly) likely to have mismatch in schemas. As we can't inspect and address all issues, schema being updated as we find issues. Any contributions are welc. The API exposes 48 endpoints secured with bearer, oauth2 authentication.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Raindrop.io API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Raindrop.io API.
Get root collections
Reorder all collections
Remove multiple collections
Merge collections
Create collection
Patterns agents use Raindrop.io API for, with concrete tasks.
★ Storage and Databases Operations
Use the Raindrop API (Unofficial) to perform storage operations programmatically. The API provides 48 endpoints covering core functionality including get root collections, reorder all collections, remove multiple collections.
Call GET /collections to get root collections
Automated Collections Management
Automate collections operations by combining multiple Raindrop API (Unofficial) endpoints. Agents can reorder all collections and then remove multiple collections in a single workflow.
Call PUT /collections to reorder all collections, then verify the result
AI Agent Integration via Jentic
AI agents discover and call Raindrop API (Unofficial) endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle bearer, oauth2 tokens manually.
Search Jentic for 'get root collections', load the operation schema, and execute with Jentic-managed credentials
48 endpoints — **unofficial** openapi specification of raindrop api.
METHOD
PATH
DESCRIPTION
/collections
Get root collections
/collections
Reorder all collections
/collections
Remove multiple collections
/collections/childrens
Get child collections
/collections/merge
Merge collections
/collections/clean
Remove all empty collections
/collection
Create collection
/collection/{id}
Get collection
/collections
Get root collections
/collections
Reorder all collections
/collections
Remove multiple collections
/collections/childrens
Get child collections
/collections/merge
Merge collections
/collections/clean
Remove all empty collections
/collection
Create collection
/collection/{id}
Get collection
Three things that make agents converge on Jentic-routed access.
Credential isolation
Raindrop API (Unofficial) bearer, oauth2 credentials are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — raw secrets never enter the agent context.
Intent-based discovery
Agents search by intent (e.g., 'get root collections') and Jentic returns the matching Raindrop API (Unofficial) operation with its input schema, so the agent can call the right endpoint without browsing docs.
Time to first call
Direct Raindrop API (Unofficial) integration: 1-3 days for auth handling, response parsing, and error cases. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Raindrop.io API through Jentic.
What authentication does the Raindrop API (Unofficial) use?
The Raindrop API (Unofficial) uses bearer, oauth2 authentication. Through Jentic, these credentials are stored encrypted in the MAXsystem vault and injected at execution time, so raw secrets never enter the agent context.
Can I get root collections with the Raindrop API (Unofficial)?
Yes. Use the GET /collections endpoint. The API returns structured JSON responses that agents can parse and act on directly.
What are the rate limits for the Raindrop API (Unofficial)?
Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.
How do I get root collections through Jentic?
Install the Jentic SDK with pip install jentic, authenticate at https://app.jentic.com/sign-up, then search for 'get root collections'. Jentic returns the matching Raindrop API (Unofficial) operation with its input schema. Load the schema and execute the call — credentials are injected automatically.
How many endpoints does the Raindrop API (Unofficial) have?
The Raindrop API (Unofficial) exposes 48 endpoints covering collections, sharing, raindrops operations.
GET STARTED