Get a publication
Returns a single publication with its (membership-gated) price.
Returns a single publication with its (membership-gated) price.
Authorization
bearerAuth publications:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: publications:read
Path Parameters
The publication id.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "id": "string", "title": "string", "subtitle": "string", "publisher": "string", "isbn": "string", "editor": "string", "author": "string", "page_count": -9007199254740991, "publication_year": -9007199254740991, "dimensions_text": "string", "inventory_number": "string", "description": "string", "stock_quantity": -9007199254740991, "availability_state": "available", "cover_image_path": "string", "published_at": "string", "visibility": "public", "show_price_publicly": true, "price_cents": -9007199254740991, "currency": "string", "metadata": { "property1": "string", "property2": "string" }, "created_at": "string", "updated_at": "string", "save_state": "new"}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}Discard a publication's draft POST
Drops the pending draft, reverting the working copy to the last saved state. The saved publication is unchanged.
List publications GET
Lists the gallery's publications (books, catalogues, editioned multiples) with cursor pagination. Filter by `visibility` or `availability_state`, fetch an explicit set with `ids` (comma-separated, max 50), or search with `q` — matches the title and inventory number. A read-only key sees only published, public/unlisted publications; each carries its price only when public-priced.