POST /books

Creates a Book resource.

Body Required

The new Book resource

  • isbn string | null
  • title string
  • description string
  • author string
  • publicationDate string(date-time)
  • reviews array[string(iri-reference)]

Body Required

The new Book resource

  • isbn string | null
  • title string
  • description string
  • author string
  • publicationDate string(date-time)
  • reviews array[string(iri-reference)]

Body Required

The new Book resource

  • isbn string | null
  • title string
  • description string
  • author string
  • publicationDate string(date-time)
  • reviews array[string(iri-reference)]

Responses

  • 201

    Book resource created

    Hide response attributes Show response attributes object

    • @context string | object

      One of:
      string-1 string object-2 object
    • @id string
    • @type string
    • id integer
    • isbn string | null
    • title string
    • description string
    • author string
    • publicationDate string(date-time)
    • reviews array[string(iri-reference)]
    Hide response attributes Show response attributes object
    • id integer
    • isbn string | null
    • title string
    • description string
    • author string
    • publicationDate string(date-time)
    • reviews array[string(iri-reference)]
    Hide response attributes Show response attributes object
    • id integer
    • isbn string | null
    • title string
    • description string
    • author string
    • publicationDate string(date-time)
    • reviews array[string(iri-reference)]
  • 400

    Invalid input

  • 422

    Unprocessable entity

POST /books 
curl \
 --request POST 'http://api.example.com/books' \
 --header "Content-Type: application/ld+json"
curl \
 --request POST 'http://api.example.com/books' \
 --header "Content-Type: application/json" \
 --data '{"isbn":"string","title":"string","description":"string","author":"string","publicationDate":"2026-05-04T09:42:00Z","reviews":["string"]}'
curl \
 --request POST 'http://api.example.com/books' \
 --header "Content-Type: text/html"
Request examples 
{
  "isbn": "string",
  "title": "string",
  "description": "string",
  "author": "string",
  "publicationDate": "2026-05-04T09:42:00Z",
  "reviews": [
    "string"
  ]
}
Request examples 
{
  "isbn": "string",
  "title": "string",
  "description": "string",
  "author": "string",
  "publicationDate": "2026-05-04T09:42:00Z",
  "reviews": [
    "string"
  ]
}
Response examples (201) 
{
  "@context": "string",
  "@id": "string",
  "@type": "string",
  "id": 42,
  "isbn": "string",
  "title": "string",
  "description": "string",
  "author": "string",
  "publicationDate": "2026-05-04T09:42:00Z",
  "reviews": [
    "string"
  ]
}
Response examples (201) 
{
  "id": 42,
  "isbn": "string",
  "title": "string",
  "description": "string",
  "author": "string",
  "publicationDate": "2026-05-04T09:42:00Z",
  "reviews": [
    "string"
  ]
}