reader

Create or update an audiobook

Idempotent upsert keyed on the path id — safe to retry, and safe to call from several of your own devices. title is required; any other field you omit keeps the value it already had.

put/v1/reader/audiobooks/{audiobookId}

Request

  • Base URL: https://api.ditto.audio (the document declares no server; this is the origin it was published from)
  • URL: https://api.ditto.audio/v1/reader/audiobooks/{audiobookId}
  • Auth: HTTP bearer

Path parameters

audiobookIdstring required

Your id for this audiobook.

Request body

idstring

Your own stable id for this audiobook (an ISBN, a uuid, your primary key). Ignored on PUT — the path wins. Omit on POST and one is generated.

titlestring required
authorstring
formatstring

Source document type.

chapterCountnumber

How many chapters the source has.

contentHashstring

sha-256 of the source file, lowercase hex. Enables upload dedup.

coverImageUrlstring

https:// or data:image/ URL.

Example request

{
  "id": "moby-dick",
  "title": "Moby-Dick",
  "author": "Herman Melville",
  "format": "epub"
}

Changes

No recorded changes to this operation across all 1 revision of this API.