# Flow Download Manager API

## API Docs
- Public [Health check](https://docs.dagbooks.org/health-check-31815657e0.md): 
- Public [List published books](https://docs.dagbooks.org/list-published-books-31815658e0.md): 
- Public [Request a single book download](https://docs.dagbooks.org/request-a-single-book-download-31815659e0.md): Creates or updates a contact record, logs the download event with GeoIP
- Public [Request a bulk download (all books for a language)](https://docs.dagbooks.org/request-a-bulk-download-all-books-for-a-language-31815660e0.md): Same as single download but returns a ZIP URL containing all active files
- Public [Download a file via token](https://docs.dagbooks.org/download-a-file-via-token-31815661e0.md): Streams the file (PDF, EPUB, or ZIP for bulk downloads).
- Books [List all books](https://docs.dagbooks.org/list-all-books-31815662e0.md): 
- Books [Create a book](https://docs.dagbooks.org/create-a-book-31815663e0.md): 
- Books [Get book details](https://docs.dagbooks.org/get-book-details-31815664e0.md): 
- Books [Update a book](https://docs.dagbooks.org/update-a-book-31815665e0.md): 
- Books [Soft-delete a book](https://docs.dagbooks.org/soft-delete-a-book-31815666e0.md): Sets `isActive = 0` for the book and all associated files.
- Books [Bulk upsert books](https://docs.dagbooks.org/bulk-upsert-books-31815667e0.md): Creates or updates multiple books in a single request.
- Books [Reorder books](https://docs.dagbooks.org/reorder-books-31815668e0.md): 
- Files [List files for a book](https://docs.dagbooks.org/list-files-for-a-book-31815669e0.md): 
- Files [Add a file (local upload or cloud link)](https://docs.dagbooks.org/add-a-file-local-upload-or-cloud-link-31815670e0.md): 
- Files [Upload or replace a file](https://docs.dagbooks.org/upload-or-replace-a-file-31815671e0.md): Replaces the existing file for the given book + language + fileType combination.
- Files [Update file metadata](https://docs.dagbooks.org/update-file-metadata-31815672e0.md): Currently only supports updating the legacy download count.
- Files [Delete a file](https://docs.dagbooks.org/delete-a-file-31815673e0.md): Soft-deletes the DB record and removes the local file from disk.
- Translations [Add or update a translation](https://docs.dagbooks.org/add-or-update-a-translation-31815674e0.md): Inserts a new translation or updates the existing one for the book + language pair.
- Translations [Delete a translation](https://docs.dagbooks.org/delete-a-translation-31815675e0.md): 
- Languages [List all languages](https://docs.dagbooks.org/list-all-languages-31815676e0.md): 
- Languages [Create a language](https://docs.dagbooks.org/create-a-language-31815677e0.md): 
- Languages [Get language usage stats](https://docs.dagbooks.org/get-language-usage-stats-31815678e0.md): 
- Languages [Update a language](https://docs.dagbooks.org/update-a-language-31815679e0.md): 
- Languages [Delete a language](https://docs.dagbooks.org/delete-a-language-31815680e0.md): Hard-deletes the language and cascades to translations, files, and publications.
- Channels [List distribution channels](https://docs.dagbooks.org/list-distribution-channels-31815681e0.md): 
- Channels [Create a channel](https://docs.dagbooks.org/create-a-channel-31815682e0.md): 
- Channels [Update a channel](https://docs.dagbooks.org/update-a-channel-31815683e0.md): 
- Channels [Delete a channel](https://docs.dagbooks.org/delete-a-channel-31815684e0.md): Cascades deletion to all publication mappings for this channel.
- Channels [Get publication matrix](https://docs.dagbooks.org/get-publication-matrix-31815685e0.md): Returns which books are published to which channels for a given language.
- Channels [Toggle a publication](https://docs.dagbooks.org/toggle-a-publication-31815686e0.md): Publishes a book to a channel or removes the publication if it already exists.
- Contacts [List contacts (paginated)](https://docs.dagbooks.org/list-contacts-paginated-31815687e0.md): 
- Contacts [Get contact details with download history](https://docs.dagbooks.org/get-contact-details-with-download-history-31815688e0.md): 
- Contacts [Export contacts as CSV](https://docs.dagbooks.org/export-contacts-as-csv-31815689e0.md): Same filters as the contacts list endpoint.
- Analytics [Dashboard summary](https://docs.dagbooks.org/dashboard-summary-31815690e0.md): 
- Analytics [Downloads over time](https://docs.dagbooks.org/downloads-over-time-31815691e0.md): 
- Analytics [Downloads by book](https://docs.dagbooks.org/downloads-by-book-31815692e0.md): 
- Analytics [Downloads by country](https://docs.dagbooks.org/downloads-by-country-31815693e0.md): 
- Analytics [Downloads by language](https://docs.dagbooks.org/downloads-by-language-31815694e0.md): 
- Analytics [Downloads by device type](https://docs.dagbooks.org/downloads-by-device-type-31815695e0.md): 
- Analytics [Download event log (paginated)](https://docs.dagbooks.org/download-event-log-paginated-31815696e0.md): 
- Analytics [Export download events as CSV](https://docs.dagbooks.org/export-download-events-as-csv-31815697e0.md): 
- Settings [Get app settings](https://docs.dagbooks.org/get-app-settings-31815698e0.md): 
- Settings [Update GeoIP database](https://docs.dagbooks.org/update-geoip-database-31815699e0.md): Downloads the latest GeoLite2-City.mmdb from MaxMind.
- API Keys [List API keys](https://docs.dagbooks.org/list-api-keys-31815700e0.md): 
- API Keys [Create an API key](https://docs.dagbooks.org/create-an-api-key-31815701e0.md): The plaintext key is returned **only once** in the response.
- API Keys [Revoke an API key](https://docs.dagbooks.org/revoke-an-api-key-31815702e0.md): Sets `isActive = 0`. The key can no longer be used for authentication.

## Schemas
- [Error](https://docs.dagbooks.org/error-13862581d0.md): 
- [Pagination](https://docs.dagbooks.org/pagination-13862582d0.md): 
- [PublicBook](https://docs.dagbooks.org/publicbook-13862583d0.md): 
- [AdminBook](https://docs.dagbooks.org/adminbook-13862584d0.md): 
- [BookDetail](https://docs.dagbooks.org/bookdetail-13862585d0.md): 
- [BookFile](https://docs.dagbooks.org/bookfile-13862586d0.md): 
- [Translation](https://docs.dagbooks.org/translation-13862587d0.md): 
- [Language](https://docs.dagbooks.org/language-13862588d0.md): 
- [Channel](https://docs.dagbooks.org/channel-13862589d0.md): 
- [ApiKey](https://docs.dagbooks.org/apikey-13862590d0.md): 
- [Contact](https://docs.dagbooks.org/contact-13862591d0.md): 
- [DownloadEvent](https://docs.dagbooks.org/downloadevent-13862592d0.md):