Add tags support to document updates and update API schemas#4
Open
vinothpandian wants to merge 3 commits into
Open
Add tags support to document updates and update API schemas#4vinothpandian wants to merge 3 commits into
vinothpandian wants to merge 3 commits into
Conversation
- Add tags parameter to UpdateDocumentRequest interface - Update ReadwiseTag interface to use 'key' instead of 'id' field - Update category enums across all interfaces to match current API - Remove deprecated: book, youtube, podcast - Add new categories: rss, highlight, note, epub - Remove shortlist from update location enum (not supported by API) - Add tags parameter to readwise_update_document tool schema - Update documentation to reflect API changes and limitations
- Fix listTags to handle paginated API response (was assuming array) - Add missing parameters to save_document: should_clean_html, title, author, summary, published_date, image_url, saved_using, notes - Add missing 'seen' parameter to update_document - Add withRawSourceUrl parameter to list_documents - Add reading_time and raw_source_url to ReadwiseDocument type - Remove 'shortlist' from CREATE location enum (only valid for LIST) - Update CLAUDE.md to reference API docs file - Add local copy of Readwise Reader API documentation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add readwise_update_document_tags for single document tag updates - Add readwise_bulk_update_tags for bulk tag operations - Both tools support "replace" (default) and "add" modes - Remove readwise_delete_document tool and related code 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #5
Summary
Changes Made
tagsparameter toUpdateDocumentRequestinterface andreadwise_update_documenttool schemaReadwiseTaginterface to usekeyfield instead ofidto match API response formatbook,youtube,podcastrss,highlight,note,epubshortlistfrom update location enum (not supported by update endpoint)API Reference
Changes based on the official Readwise Reader API documentation: https://readwise.io/reader_api
Updated on: 2025-09-12
Breaking Changes
ReadwiseTag.idfield renamed toReadwiseTag.keyshortlistlocation (filtering still supports it)