> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Readwise Reader

> Save, list, organize, update, and delete documents in a Readwise Reader library.

![Readwise Reader logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/readwise_reader.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=4e83d13127658c40bf568084c390a8a4)

* **Category:** bookmark managers
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 7
* **Triggers:** 0
* **Slug:** `READWISE_READER`
* **Version:** 20261103\_00

## Tools

> [accordion] Bulk Update Documents
>
> **Slug:** `READWISE_READER_BULK_UPDATE_DOCUMENTS`
>
> Partially update up to 50 Reader documents in one request and return a success or error result for every document.
>
> #### Input Parameters
>
> **updates** `array` *required*
>
> One to 50 independent partial updates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Highlights
>
> **Slug:** `READWISE_READER_CREATE_HIGHLIGHTS`
>
> Create or update one or more highlights in the connected Readwise library and return the affected sources and modified highlight IDs.
>
> #### Input Parameters
>
> **highlights** `array` *required*
>
> One or more highlights to create or update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Document
>
> **Slug:** `READWISE_READER_DELETE_DOCUMENT`
>
> Permanently delete one Reader document by its ID. Deleting a document also deletes its highlights and their notes; deleting a highlight also deletes its note.
>
> #### Input Parameters
>
> **document\_id** `string` *required*
>
> Reader document ID to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Documents
>
> **Slug:** `READWISE_READER_LIST_DOCUMENTS`
>
> List, filter, incrementally sync, or fetch a specific Reader document. Returns one page and a cursor for the next page.
>
> #### Input Parameters
>
> **tags** `array`
>
> Require all supplied tag names, up to five. Use a list containing one empty string to find untagged documents.
>
> **limit** `integer`
>
> Maximum documents to return in this page (1-100).
>
> **category** `string ("article" | "email" | "rss" | "highlight" | "note" | "pdf" | "epub" | "tweet" | "video")`
>
> Filter by document category.
>
> **location** `string ("new" | "later" | "shortlist" | "archive" | "feed")`
>
> Filter by Reader location.
>
> **document\_id** `string`
>
> Return only the document with this Reader ID; no match returns an empty results array.
>
> **next\_cursor** `string`
>
> Cursor returned as next\_cursor by a previous call; omit for the first page and pass it back unchanged.
>
> **updated\_after** `string`
>
> Return documents updated after this ISO 8601 datetime for incremental synchronization.
>
> **with\_html\_content** `boolean`
>
> Include html\_content in each result; this can increase processing time and response size.
>
> **with\_raw\_source\_url** `boolean`
>
> Include a direct source URL valid for one hour when distribution is allowed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tags
>
> **Slug:** `READWISE_READER_LIST_TAGS`
>
> List tags in the connected Reader library, returning one page and a cursor for the next page.
>
> #### Input Parameters
>
> **next\_cursor** `string`
>
> Cursor returned as next\_cursor by a previous call. Omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Save Document
>
> **Slug:** `READWISE_READER_SAVE_DOCUMENT`
>
> Save a document in the connected Reader library using a required URL and optional supplied HTML, metadata, location, and tags. Returns the Reader document ID needed by update and delete tools.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Unique source URL. Use a stable synthetic URL when the document has no real URL; Reader scrapes it when html is omitted.
>
> **html** `string`
>
> Valid HTML content to save instead of asking Reader to scrape the URL.
>
> **tags** `array`
>
> Tag names to assign to the saved document.
>
> **notes** `string`
>
> Top-level note to store on the document.
>
> **title** `string`
>
> Title override for the saved document.
>
> **author** `string`
>
> Author override for the saved document.
>
> **summary** `string`
>
> Summary to store on the document.
>
> **category** `string ("article" | "email" | "rss" | "highlight" | "note" | "pdf" | "epub" | "tweet" | "video")`
>
> Document category; Reader usually infers article when omitted.
>
> **language** `string`
>
> Language code such as en, de, or en-US; Reader auto-detects it when omitted.
>
> **location** `string ("new" | "later" | "archive" | "feed")`
>
> Initial Reader location.
>
> **image\_url** `string`
>
> Cover image URL.
>
> **saved\_using** `string`
>
> Name of the source or integration that saved the document.
>
> **published\_date** `string`
>
> ISO 8601 publication datetime; Reader assumes UTC when no timezone is supplied.
>
> **should\_clean\_html** `boolean`
>
> Whether Reader should clean supplied HTML and derive title and author metadata. Only use with html. When false, title and author are required; omit this field to use Reader's default behavior.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Document
>
> **Slug:** `READWISE_READER_UPDATE_DOCUMENT`
>
> Partially update supported fields on one Reader document by ID; omitted fields remain unchanged. For highlights, only notes and tags can be updated; notes cannot be updated directly.
>
> #### Input Parameters
>
> **seen** `boolean`
>
> True marks the document seen and records open times; false clears those times.
>
> **tags** `array`
>
> Complete replacement list of tag names.
>
> **notes** `string`
>
> Replacement top-level document note; an empty string clears it. This field cannot add notes to highlight documents.
>
> **title** `string`
>
> Replacement title.
>
> **author** `string`
>
> Replacement author.
>
> **summary** `string`
>
> Replacement summary.
>
> **category** `string ("article" | "email" | "rss" | "highlight" | "note" | "pdf" | "epub" | "tweet" | "video")`
>
> Replacement document category.
>
> **language** `string`
>
> Replacement language code such as en, de, or en-US.
>
> **location** `string ("new" | "later" | "archive" | "feed")`
>
> Move the document to this Reader location.
>
> **image\_url** `string`
>
> Replacement cover image URL.
>
> **document\_id** `string` *required*
>
> Reader document ID to update.
>
> **published\_date** `string`
>
> Replacement publication datetime; Reader assumes UTC when no timezone is supplied.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
