Get Started with the API

You can sync GitBook pages with an OpenAPI or Swagger file or a URL to include auto-generated API methods in your documentation.

Example OpenAPI block

GitBook's OpenAPI block is powered by Scalar, so you can test your APIs directly from your docs.

Add a new pet to the store

Add a new pet to the store

POST/api/v3/pet

Authorization

petstore_auth

Body

application/jsonapplication/xmlapplication/x-www-form-urlencoded

Create a new pet in the store

idinteger (int64)

Example: 10

name*string

Example: "doggie"

categoryCategory (object)

photoUrls*array of string

tagsarray of Tag (object)

statusenum

pet status in the store

availablependingsold

Response

200405

Successful operation

Body

application/xmlapplication/json

idinteger (int64)

Example: 10

name*string

Example: "doggie"

categoryCategory (object)

photoUrls*array of string

tagsarray of Tag (object)

statusenum

pet status in the store

availablependingsold

Request

JavaScriptCurlPython

const response = await fetch('/api/v3/pet', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "doggie",
      "photoUrls": [
        "text"
      ]
    }),
});
const data = await response.json();

Response

200

{
  "id": 10,
  "name": "doggie",
  "category": {
    "id": 1,
    "name": "Dogs"
  },
  "photoUrls": [
    "text"
  ],
  "tags": [
    {
      "name": "text"
    }
  ],
  "status": "available"
}