Create a book

Books API›Books

POSThttps://api.example.com/v1/books

AuthRequires authentication via bearerAuth.

Description

Adds a book to the catalog.

Request

cURLJavaScriptPython

Copy

curl -X POST "https://api.example.com/v1/books" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "The Soul of a New Machine",
  "author": "Tracy Kidder",
  "published_year": 1981,
  "tags": [
    "computing",
    "history"
  ]
}'

const response = await fetch("https://api.example.com/v1/books", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
      "title": "The Soul of a New Machine",
      "author": "Tracy Kidder",
      "published_year": 1981,
      "tags": [
        "computing",
        "history"
      ]
    }),
});

import requests

response = requests.post(
    "https://api.example.com/v1/books",
    headers={
      "Authorization": "Bearer YOUR_TOKEN"
    },
    json={
      "title": "The Soul of a New Machine",
      "author": "Tracy Kidder",
      "published_year": 1981,
      "tags": [
        "computing",
        "history"
      ]
    },
)

Response201JSONCopy

{
  "id": "bk_7c4e9a10",
  "title": "The Soul of a New Machine",
  "author": "Tracy Kidder",
  "published_year": 1981,
  "tags": [
    "computing",
    "history"
  ]
}

Request body

application/jsonrequired

titlebodystringrequired

authorbodystringrequired

published_yearbodyinteger

tagsbodystring[]

Responses

201The created book.application/json

idstringrequired

Unique identifier.

titlestringrequired

The book title.

authorstringrequired

The author's full name.

published_yearinteger

Year of first publication.

tagsstring[]

Free-form labels.

422Validation error.