Covers

Get a cover and its asset availability

Returns the cover's metadata and, for each of the six asset types (preview, full, audiobook_preview, audiobook_full, no_text, no_text_full), whether it exists plus a 1-hour signed download URL when it does.

get/api/v1/covers/{coverId}

Request

  • Base URL: https://beyourcover.com
  • URL: https://beyourcover.com/api/v1/covers/{coverId}
  • Auth: HTTP bearer

Path parameters

coverIdstring uuid required

The cover's public id (UUID) as returned in job results (covers[].coverId).

Response

Cover detail.

coverIdstring uuid required

The cover's public id.

bookIdstring uuid required
coverStylestring nullable required
visibility'default' | 'favorite' | 'hidden' required

favorite covers lead their book on the shelf (the newest one wins); hidden covers stay out of GET /api/v1/books/{bookId}/covers unless include_hidden=true. Set it with PATCH /api/v1/covers/{coverId}.

Changes

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