BUbuttondown
Books

Create Book

Changed on

Create a new book

post/books

Request

  • Base URL
    https://api.buttondown.com/v1
  • URL
    https://api.buttondown.com/v1/books
  • Auth
    API key in header Authorization

Request body

titlestring required

The title of the book.

urlstring

The URL where the book can be purchased or viewed.

image_urlstring

The URL of the book's cover image.

descriptionstring

A description of the book.

yearinteger nullable

The year the book was published.

isbnstring

The ISBN of the book.

sharedboolean

Whether the book is displayed publicly on the archive.

Response

Created

idstring required

A unique TypeID associated with the object.

creation_datestring date-time required

The date and time at which the object was first created.

titlestring required

The title of the book.

urlstring

The URL where the book can be purchased or viewed.

image_urlstring

The URL of the book's cover image.

descriptionstring

A description of the book.

yearinteger nullable

The year the book was published.

isbnstring

The ISBN of the book.

sharedboolean

Whether the book is displayed publicly on the archive.

Changes

  • 228cc05ba97dRevision changes
    • info

      added the non-success response with the status

  • 13f3bc084194Revision changes
    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      response property year list-of-types was widened by adding types null to media type application/json of response 201

    • breaking

      the response's property type changed from no type to string for status

    • breaking

      the response's property type changed from no type to string for status

    • warning

      the request property's maxLength was set to 2000

    • warning

      the request property's maxLength was set to 20

    • warning

      the request property's maxLength was set to 500

    • warning

      the request property's maxLength was set to 2000

    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the endpoint scheme security PermissionAuthenticationRequirement was removed from the API

    • info

      api tag Books added

    • info

      added the new optional request property

    • info

      the request property default value was added

    • info

      the request property default value was added

    • info

      the request property default value was added

    • info

      the request property default value was added

    • info

      request property list-of-types was widened by adding types null to media type application/json

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      the response's property default value was added for the status

    • info

      the response's property default value was added for the status

    • info

      the response's property default value was added for the status

    • info

      the response's property default value was added for the status