PublishDrive
Api

Publish a book

Submit the book for distribution processing (initial publish or republish after edits).

The book must be in draft (or reach a publishable state after final validation). Use this endpoint after create, and again after any successful book update or file attach that moved a formerly non-draft book back to draft.

Runs final validation on the book. If the stored publication date is today or in the past, or within the next 14 days, isFinalVersion must be true; otherwise the request fails with 422 (same rules as the legacy PublishDrive book form).

POST
/books/{bookPublicId}/publish
apikey<token>

In: header

Path Parameters

bookPublicId*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://api.publishdrive.com/v2/distribution/books/e9e0d147-52cb-11f1-8d0d-aedf0546306a/publish" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
Empty
{
  "message": "Book not found"
}

{
  "title": "Unprocessable Content",
  "status": 422,
  "detail": "Validation failed",
  "instance": "/v2/distribution/books/e9e0d147-52cb-11f1-8d0d-aedf0546306a/publish",
  "invalidParams": []
}

On this page