1. Public
Dag Books API Docs
  • Public
    • Health check
      GET
    • List published books
      GET
    • Request a single book download
      POST
    • Request a bulk download (all books for a language)
      POST
    • Download a file via token
      GET
    • Get public cover image with fallback
      GET
    • Get the favicon as a 256px link-preview icon
      GET
  • Books
    • List all books
      GET
    • Create a book
      POST
    • Get book details
      GET
    • Update a book
      PUT
    • Archive or permanently delete a book
      DELETE
    • Bulk upsert books
      POST
    • Reorder books
      PATCH
    • Restore an archived book
      POST
  • Files
    • List files for a book
      GET
    • Add a file (local upload or cloud link)
      POST
    • Upload or replace a file
      PUT
    • Update file metadata
      PATCH
    • Delete a file
      DELETE
  • Translations
    • Add or update a translation
      POST
    • Delete a translation
      DELETE
  • Languages
    • List all languages
      GET
    • Create a language
      POST
    • Get language usage stats
      GET
    • Update a language
      PUT
    • Delete a language
      DELETE
    • Get book visibility for a sub-language
      GET
    • Update book visibility for a sub-language
      PUT
  • Channels
    • List distribution channels
    • Create a channel
    • Update a channel
    • Delete a channel
    • Get publication matrix
    • Toggle a publication
  • Contacts
    • List contacts (paginated)
    • Get contact details with download history
    • Export contacts as CSV
  • Analytics
    • Dashboard summary
    • Downloads over time
    • Downloads by book
    • Downloads by country
    • Downloads by language
    • Downloads by device type
    • Download event log (paginated)
    • Export download events as CSV
  • Settings
    • Get app settings
    • Update GeoIP database
  • API Keys
    • List API keys
    • Create an API key
    • Revoke an API key
  • Covers
    • List all covers across all active books
    • List covers for a specific book
    • Upload or replace a cover image
    • Delete a cover image
    • Get cover image binary (admin)
  • Schemas
    • Error
    • Pagination
    • PublicBook
    • AdminBook
    • BookDetail
    • BookFile
    • Translation
    • CoverMetadata
    • Language
    • Channel
    • ApiKey
    • SubLanguageBookOverride
    • Contact
    • DownloadEvent
  1. Public

Get the favicon as a 256px link-preview icon

GET
/api/settings/share-icon
256px PNG copy of the site favicon, rendered with sharp and cached in memory (keyed by file mtime).
?sales=1, or a request whose host is the sales_domain setting, serves the sales favicon (falling back to the site favicon).
.ico uploads pass through unresized. When no favicon is configured the default public/favicon.ico is served, so the route never 404s.
Used as the public pages' og:image / twitter:image and <link rel="icon">. /favicon.ico is rewritten to this route, so link scrapers that fetch it directly get the uploaded favicon. Kept under 300px so WhatsApp renders the compact icon-beside-title card instead of a large tile.

Request

Query Params

Responses

🟢200OK
image/png
Icon image
Headers

Bodyimage/png

🔵304
🔴503Service Unavailable
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/settings/share-icon?sales=undefined&v=undefined'
Response Response Example
{}
Modified at 2026-09-11 13:45:45
Previous
Get public cover image with fallback
Next
List all books
Built with