add_article
ChatGPTSave a link the user chose to their Folio reading list, to read later on their e-reader. Folio keeps a private reading copy for that user only, prepared in the background, so it is not available immediately.
add_markdown
ChatGPTSave text the assistant wrote (or already has) straight to the user's Folio inbox as Markdown. Nothing is fetched or cleaned up: the body is stored as given, tables and all. Use add_article for a URL instead.
archive_article
ChatGPTArchive one saved article: move it from the inbox to the library. Call list_articles for the id.
create_issue
ChatGPTBuild an issue from saved articles. Inbox articles move to the library, rendering runs in the background, and existing automatic delivery settings can send the completed issue to connected devices or services. Poll get_issue for render status.
create_schedule
ChatGPTCreate a delivery schedule that builds an issue from the user's saved articles on a cadence (daily, weekdays, weekly or biweekly) and sends it with the user's existing delivery settings. Needs a paid Folio plan.
create_upload
ChatGPTGet a one-time URL for putting a PDF or EPUB into Folio so it can be sent to a device. Run the returned curl_command in a shell to upload the file. Never paste file contents into this conversation. If you have no shell, give the user drop_page_url to upload it themselves. The link is single-use and expires in 15 minutes.
fetch
ChatGPTOpen one item from the user's own Folio library by id, as returned by search: the private reading copy of an article they chose to save. Does not fetch URLs.
get_article
ChatGPTOpen one item from the user's own Folio library by id: the private reading copy of an article they chose to save, including its text (body_html).
get_issue
ChatGPTGet one issue's status, which formats are available to download, the articles it contains, and a download URL.
get_settings
ChatGPTGet the user's Folio account settings: inbox email, plan, timezone and quota usage. inbox_email is null until the user has set up their inbound address in the Folio app. Read-only: changes nothing.
list_articles
ChatGPTList the user's saved articles, most recent first. Use status "inbox" for unread items, "library" for archived ones, "failed" for articles Folio could not fetch, and "trashed" for deleted ones. Returns titles, URLs, sources and word counts, not the saved copy itself; call get_article for that. Results are paginated: when the response has has_more: true, call again with offset set to next_offset to get older items.
list_feeds
ChatGPTList the RSS feeds the user is subscribed to, with their folder.
list_issues
ChatGPTList the issues (generated digests) the user has created, most recent first.
list_schedules
ChatGPTList the user's delivery schedules (Auto Schedule), with cadence and next run.
list_sent_files
ChatGPTList the files Folio has recently sent to the user's connected devices, most recent first.
list_sources
ChatGPTList the distinct publications/sources of the user's inbox articles, with counts.
list_targets
ChatGPTList the devices and services the user can receive files on, with the largest file each accepts. Call this before send_file to pick a target that is connected and will accept the file size.
move_feed
ChatGPTMove one of the user's RSS feeds into a folder, or out of any folder with folder_id null. Call list_feeds first to get feed and folder ids.
pause_schedule
ChatGPTPause a delivery schedule so it stops building and sending issues until resumed. Call list_schedules for the id.
restore_article
ChatGPTRestore one article from the trash or the library back to the inbox. Call list_articles for the id.
resume_schedule
ChatGPTResume a paused delivery schedule. From its next run it builds and sends issues again with the user's delivery settings. Call list_schedules for the id.
search
ChatGPTSearch the articles the user has saved in their own Folio library, by title or URL. Only returns items the user saved; it does not search the web.
send_file
ChatGPTSend a file to one of the user's connected devices. Pass file_id from create_upload (after the upload finished), or issue_id to send an existing Folio issue. Call list_targets first to see what is connected and what size each accepts. Files are sent unchanged and are not kept in the library. A temporary upload is consumed after the first delivery attempt, including a failed attempt.
send_markdown
ChatGPTWrite a document and send it to one of the user's devices in one step. The Markdown is saved to Folio, rendered as an e-ink PDF in the background, then delivered to the target when ready, usually within a couple of minutes. Use this for "make X and send it to my reMarkable". Call list_targets first to see what is connected. The title is rendered separately, so omit a duplicate H1 title from the Markdown body. Poll get_issue with the returned issue_id for status.
set_article_category
ChatGPTFile one saved article under a category, replacing its current one; an empty category clears it.
subscribe_feed
ChatGPTSubscribe the user to an RSS or Atom feed by its URL. Folio fetches the feed from the web and, if auto_add is on, adds new items to the inbox.
trash_article
ChatGPTMove one saved article to the trash. It can be brought back with restore_article. Call list_articles for the id.
unsubscribe_feed
ChatGPTUnsubscribe the user from one RSS feed. Call list_feeds first to get the feed id.
update_schedule
ChatGPTChange an existing delivery schedule: only the fields passed are changed, the rest keep their values. Call list_schedules first for the id. Needs a paid Folio plan.